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1 . Introduction 



Overview 



This document describes the 2.0 Release of the ES V Workstation software. 

Chapter 1, "Introduction," (this chapter) describes the functionality 
added in the 2.0 Release. 

Chapter 2, "Known Bugs in the System," describes the system, 
ES/os, ES/PSX, ES/PEX, X Window System, and OSF/Motif bugs 
that are known to be in the 2.0 Release. 

Chapter 3, "Bugs Fixed in the Release," describes bugs that have been 
fixed in the 2.0 Release. 

Chapter 4, "Documentation Corrections," describes additions and 
corrections to the ES V Workstation documentation. 

Chapter 5, "Installation Instructions," describes the installation proce- 
dure for the tapes included in the 2.0 Release. 

Appendix A, "1.3 to 2.0 C Binding Conversion," contains information 
to assist you in the process of converting source code from the 1.3 C 
binding to the 2.0 C binding. 

Appendix B, "Change Pages," contains change pages for the ES V 
Workstation documentation. 

Additional information will be found in the following documents which 
are distributed with the 2.0 Release: 

• MIPS Software Binary Release Notes, RISCos 450 Release 

• MIPS Software Binary Release Notes, RISCos 4 SI Release 

On-line release notes for the operating system, compilers, and OSF/Motif 
are found in the /usr/pkg/rn directory. 
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ES/os2.0 



ES/PEX 2.0 



The 2.0 Release includes the following tapes: 
ES/os 2.0 

ES/PEX-Server 2.0 
ES/PEX-Library 2.0 
ES/PSX2.0 
ES/Dnet 2.0 
LAT Host Services 
Diskless Node 2.0 
Kodak Printer 2.0 
ES/AVS 2.0 

Pascal RISCompiler 2. 1 1 
Fortran RISCompiler 2.1 1 
Ada RISCompiler 3.0 
Dociimenter's Workbench 

The ES/os 2.0 Release is based on the 4.5.1 Release of RISC/os. 



The ES/PEX-Server 2.0 Release is based on the PEX-SI release, which sup- 
ports the 5. OP protocol specification of PEX. Hence, PEX programs which run 
on releases prior to the 2.0 release will not run on the 2.0 release. Please see 
pages 1-27 and 1-28 of the ESV Workstation Reference Manual, and also ap- 
pendix A, "1.3 to 2.0 C Conversion," of these Release Notes for information 
about how to make the necessary changes in your programs. 

The ES/PEX-Motif 2.0 Release is based on the OSF/Motif 1.1.1 Release. 
This Motif revision uses Version 11, Release 4 of the X window system, in- 
cluding the X11R4 X Toolkit Intrinsics. 1.1.1 Motif implements many en- 
hancements and new features, including enhancements to the window 
manager, mwm. For complete information, refer to the OSF/Motif Release 
Notes, Revision 1.1. L 
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Application Status Report 



This section notifies customers of any impact the 2.0 Release may have on the 
third-party applications they use. The applications are placed into one of the 
following categories: 

The 2.0 Release improves performance and/or 
fixes known bugs in the application. 

No known problems with the 2.0 Release. 



ENHANCED 

COMPATIBLE 
TESTING IN PROGRESS 



IRREGULAR 



NOT COMPATIBLE 



UPGRADE AVAILABLE 



Testing in progress at time of printing. Contact 
the vendor or Evans & Sutherland Technical 
Support for more information. 

Application may experience minor side effects 
with the 2.0 Release. Contact the vendor or 
Evans & Sutherland Technical Support for 
more information. 

Contact the vendor before upgrading to the 2.0 
Release. 

Not compatible with the 2.0 Release. An up- 
grade for the 2.0 Release is available from the 
vendor. 



Application Name 

AVS 

BIOGRAF/POLYGRAPH/NMRGRAF 

CDRS 

FELIX 

FRODO 

INSIGHT/DISCOVER 

MARC/MENTAT 

MEDCHEM 

MOVIESTAR.BYU 

"O" 

PARA-SERIES 

SYBYL 



Category 

ENHANCED/UPGRADE AVAILABLE 

UPGRADE AVAILABLE 

NOT COMPATIBLE 

NOT COMPATIBLE 

UPGRADE AVAILABLE 

UPGRADE AVAILABLE 

UPGRADE AVAILABLE 

COMPATIBLE 

NOT COMPATIBLE 

NOT COMPATIBLE 

NOT COMPATIBLE 

NOT COMPATIBLE 
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Added Functionality in the 2,0 Release \ 

PHIGS Functionality 

Added PHIGS Functions 

The following PHIGS functions have been added in the 2.0 Release: 

ARCHIVE ALL STRUCTURES 

ARCHIVE STRUCTURE NETWORKS 

ARCHIVE STRUCTURES 

CHANGE STRUCTURE IDENTIFIER 

CHANGE STRUCTURE IDENTIFIER AND REFERENCES 

CHANGE STRUCTURE REFERENCES 

CLOSE ARCHIVE FILE 

DELETE ALL STRUCTURES FROM ARCHIVE 

DELETE STRUCTURE NETWORKS FROM ARCHIVE 

DiLETE STRUCTURES FROM ARCHIVE 

GENERALIZED DRAWING PRIMITIVE 

GENERALIZED DRAWING PRIMITIVE 3 

GENERALIZED STRUCTURE ELEMENT 

GET CHOICE 

GET LOCATOR 

GET LOCATOR 3 

GET PICK 

GET STRING 

GET VALUATOR 

INITIALIZE CHOICE 

INITIALIZE CHOICE 3 

INITIALIZE LOCATOR 

INITIALIZE LOCATOR 3 

INITIALIZE PICK 

INITIALIZE PICK 3 

INITIALIZE STRING 

INITIALIZE STRING 3 

INITIALIZE VALUATOR 

INITIALIZE VALUATOR 3 

INQUIRE ALL CONFLICTING STRUCTURES 

INQUIRE ARCHIVE FILES 

INQUIRE ARCHIVE STATE VALUE 

INQUIRE CHOICE DEVICE STATE 

INQUIRE CHOICE DEVICE STATE 3 

INQUIRE CONFLICT RESOLUTION 

INQUIRE CONFLICTING STRUCTURES IN NETWORK 

INQUIRE DEFAULT CHOICE DEVICE DATA «, 

INQUIRE DEFAULT CHOICE DEVICE DATA 3 

INQUIRE DEFAULT LOCATOR DEVICE DATA 

INQUIRE DEFAULT LOCATOR DEVICE DATA 3 

INQUIRE DEFAULT PICK DEVICE DATA 

INQUIRE DEFAULT PICK DEVICE DATA 3 

INQUIRE DEFAULT STRING DEVICE DATA 

INQUIRE DEFAULT STRING DEVICE DATA 3 

INQUIRE DEFAULT VALUATOR DEVICE DATA jr 
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INQUIRE DEFAULT VALUATOR DEVICE DATA 3 

INQUIRE LOCATOR DEVICE STATE 

INQUIRE LOCATOR DEVICE STATE 3 

INQUIRE MODELLING CLIPPING FACILITIES 

INQUIRE MORE SIMULTANEOUS EVENTS 

INQUIRE NUMBER OF AVAILABLE LOGICAL INPUT DEVICES 

INQUIRE PICK DEVICE STATE 

INQUIRE PICK DEVICE STATE 3 

INQUIRE STRING DEVICE STATE 

INQUIRE STRING DEVICE STATE 3 

INQUIRE VALUATOR DEVICE STATE 

INQUIRE VALUATOR DEVICE STATE 3 

OPEN ARCHIVE FILE 

REQUEST CHOICE 

REQUEST LOCATOR 

REQUEST LOCATOR 3 

REQUEST PICK 

REQUEST STRING 

REQUEST VALUATOR 

RETRIEVE ALL STRUCTURES 

RETRIEVE ANCESTORS OF STRUCTURE 

RETRIEVE DESCENDANTS OF STRUCTURE 

RETRIEVE STRUCTURE IDENTIFIERS 

RETRIEVE STRUCTURE NETWORKS 

RETRIEVE STRUCTURES 

SAMPLE CHOICE 

SAMPLE LOCATOR 

SAMPLE LOCATOR 3 

SAMPLE PICK 

SAMPLE STRING 

SAMPLE VALUATOR 

SET CHOICE MODE 

SET LOCATOR MODE 

SET PICK MODE 

SET STRING MODE 

SET VALUATOR MODE 

Unsupported PHIGS Functions 

Following is a complete list of all PHIGS functions that are not supported in 
the 2.0 Release. FILL AREA 3 WITH DATA is not supported under the 2.0 
server, but it is supported if the thin layer is used. 

CELL ARRAY 

CELL ARRAY 3 

EXTENDED CELL ARRAY 3 + 

GET ITEM TYPE FROM METAFILE 

GET STROKE 

GET STROKE 3 

INCREMENTAL SPATIAL SEARCH 

INCREMENTAL SPATIAL SEARCH 3 

INITIALIZE STROKE 

INITIALIZE STROKE 3 
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INQUIRE COLOUR MAPPING FACILITIES + 

INQUIRE COLOUR MAPPING METHOD FACILITIES + 

INQUIRE COLOUR MAPPING REPRESENTATION + 

INQUIRE COLOUR MAPPING STATE+ 

INQUIRE DEFAULT STROKE DEVICE DATA 

INQUIRE DEFAULT STROKE DEVICE DATA 3 

INQUIRE LIST OF COLOUR MAPPING INDICES + 

INQUIRE PREDEFINED COLOUR MAPPING REPRESENTATION + 

INQUIRE STROKE DEVICE STATE 

INQUIRE STROKE DEVICE STATE 3 

INQUIRE TEXT EXTENT 

INTERPRET ITEM 

NON-UNIFORM B-SPLINE CURVE + 

NON-UNIFORM B-SPLINE SURFACE + 

READ ITEM FROM METAFILE 

REQUEST STROKE 

REQUEST STROKE 3 

RESTORE MODELLING CLIPPING VOLUME 

SAMPLE STROKE 

SAMPLE STROKE 3 

SET BACK PARAMETRIC SURFACE CHARACTERISTICS + 

SET COLOUR MAPPING INDEX + 

SET COLOUR MAPPING REPRESENTATION + 

SET CURVE APPROXIMATION CRITERIA + 

SET EXTENDED PA TTERN REPRESENTA TION + 

SET MODELLING CLIPPING INDICATOR 

SET MODELLING CLIPPING VOLUME 

SET MODELLING CLIPPING VOLUMES 

SET OF FILL AREA SET 3 WITH DATA + 

SET PARAMETRIC SURFACE CHARACTERISTICS + 

SET PATTERN REFERENCE POINT 

SET PATTERN REFERENCE POINT AND VECTORS 

SET PATTERN REPRESENTATION 

SET PATTERN SIZE 

SET STROKE MODE 

SET SURFACE APPROXIMA TION CRITERIA + 

SET TRIMMING CURVE APPROXIMATION CRITERIA* 

WRITE ITEM TO METAFILE 



( 



C 



1-6 2.0 Release Notes 



Introduction 



NIS (Yellow Pages) 

ES/os supports the MIPS Virtual Information Service (VIS) which provides 
the capability to use multiple information services on a single host. In the 2.0 
Release, this includes support for Sun's Network Information Service (NIS, 
formerly known as Yellow Pages, or YP) and the DARPA Domain Name ser- 
vice, as well as the standard UNIX information files. 

This is implemented by modifying the library routines which provide in- 
terfaces to these information data bases. This significantly eases the task of 
application development because the application itself does not need to know 
about the different information sources. The following commands are sup- 
ported: 

ypcat yppasswd ypbind 

ypmake yppoll ypserv 

ypupdated ypxfr ypmatch 

ypwhich ypinit yppasswdd 

yppush ypset ypwhich 

It is very important that ypbind has correctly run before you reboot your 
machine, as an improperly configured system could cause the console to hang 
when booted. 

By default, the OS distribution does not come with NIS enabled. Refer to 
the MIPS Software Binary Release Notes, RISCos 4.51 Release for a complete 
explanation of how to configure NIS. 

Users should note the following about NIS: 

• On-line manual pages are available for all NIS commands. These 
commands start with the string yp. The command man -k y p will give 
you a list of the NIS commands along with a few other unrelated com- 
mands (disregard the unrelated commands). 

• /usr/bin/domainname can be used to set your domain name interac- 
tively. This must be done before you build a database or start any of 
the servers. 

• /etc/local_domainname must contain your domain name in order for 
NIS to come up automatically when booting your system. 

• The file /etc/rc2.d/S38nis_iocal needs to be added in order for NIS 
to come up automatically when booting your system. Its contents 
should be: 

echo startup ypbind 
nohup /etc/ypbind 
/usr/bin/ypwhich 
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A sample visxonf file, /etc/vis.eonf .sample, can be moved to f 

/ete/visxonf. 

* In order to take advantage of NIS passwd and group facilities you 
must add "+::0:0:::" as the last entry in your /etc/passwd file and 
"+:" as the last entry to your /©te/group file. 



• For Diskless Node and Local Server systems, bootparamd does not 
use /etc/bootparams if NIS is, enabled. If you are running a 

Diskless Node server, you need to have added your system's 

/etc/bootparamd entries to your NIS server's bootparamd database,, 

For Local Server systems, if you are running a diskless GCPU system, 
the above note is very important. Without this change you cannot boot 
the GCPU of the Local Server system and there is no way (other than 

the network) to access a booted SCPIL 

For Local Server systems, if you have more than one diskless GCPU 
Local Server system, you do not need to include multiple 
/etc/bootparams entries on the NIS server for the GCPU. Multiple 
systems may use the same entry provided they have the same root, 
osr, and swap paths on the SCPU. If the GCPUs of multiple Local 
Server systems have differing root, usr, and swap paths, you will 
have to change the Local Server network names and add more than 
one entry to your NIS server's bootparams database. You are 
strongly urged to use the default Local Server configuration and 
naming conventions. 

• NIS will not work with old executables. Programs need to be relinked 
with 2.0 libraries. 

• To test NIS on a network where an NIS server is already running, ex- 
ecute the following commands as root: 

/usr/bin/domainname <y©ur-domainname> 

mv /etc/vis . eonf . sasaple /etc/vis. conf 

/ete/ypbind 

/usr/bin/ypwhich 

If everything is correct, the following command will cause a password 
file to be output: 

ypcat passwd - J more 

Be sure to apply the above required changes if you want your system 
to use NIS when it is rebooted. 
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xdm 

The display manager, xdm, is a new client with 2.0 which is started automat- 
ically when the ES V is booted. This starts the X server and allows users to log 
in and out without having to explicitly start and stop the X server. See chapter 
3, "Getting Started," in the ESV Workstation User's Manual for a full descrip- 
tion. 

If you do not want to run under xdm, then you can abort xdm by typing 
ALT-F4. This brings you back to the console in which you must start X ex- 
plicitly, as was required in previous releases. If you later want to restart xdm, 
you can do so by logging in as user xdm. There is no password required. This 
will cause xdm to start again. 

New Default Startup Files 

The 2.0 release has modified the files which provide the default X environ- 
ment. See chapter 3, "Getting Started" in the ESV Workstation User's Manual 
for a full description 

PHIGS Stereo 

The 2.0 Release includes stereo implementation through PHIGS. For informa- 
tion, refer to the following document which is shipped with the Stereo Option: 

Stereo User's Manual [2.0]. 

Multiple Screens 

Multiple screens (provided by the X Multiscreen Extension) allow you to ef- 
fectively expand your working surface. The term "screen" means a logical 
screen, not a physical one. When displayed, a logical screen takes up the en- 
tire surface of a monitor, and when not displayed, it is not seen. 

With multiple screens, you can configure the windows you would like on 
each screen and then not have to rearrange them (as you do now) if you need 
to look at a window that is buried in a stack or iconified. With the csm mul- 
tiscreen manager, you can switch between screens, or optionally, with the 
mouse you can switch screens to an entirely new screen of different windows. 
This general interface handles multiple logical screens, including normal 
screens, stereo screens, etc. 

For additional information, refer to the "X Extensions" chapter in the ESV 
Workstation Reference Manual [2.0]. 
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Overlay Planes I 

The X Overlay functionality provides access to the ESV Workstation overlay 
hardware. On the ESV Workstation, the total number of overlay planes is 4. 
These planes are shared with planes that identify PHIGS workstations. Each 
plane allocated for overlay reduces the total number of PHIGS workstations 
by one-half. If all 4 are allocated for overlay, a maximum number of 12 
PHIGS workstations will be available. The planes can be allocated for overlay 
from 1 to 4. 

For additional information about the X Overlay functionality, refer to the 
"X Extensions" chapter in the ESV Workstation Reference Manual [2.0], An 
example program demonstrating the use of overlay planes on the ESV Work- 
station is found in /usr/people/f stest/demo/overlayx. 

High Quality Spheres 

Both 2.0 ES/PEX and ES/PSX provide options for the static renderings of 
spheres and cylinders which are created using sphere and cylinder equations 
rather than polygonal approximations. The spheres and cylinders produced 
are smooth, and the edges and intersections are clear. 



Fast Spheres 

GDP3 spheres that are drawn with a precision value less than 40 are automat- 
ically replaced with spheres that are tessellated in the software instead of the 
DSPs. This results in faster drawing of spheres for spheres of low precision. 

PHIGS Monitor 

The PHIGS monitor enables the use of the PHIGS input model. It starts auto- 
matically when a PHIGS application is started. This process does three things: 
it monitors X events, generates PHIGS input, and redraws structures on expo- 
sure. 

The PHIGS monitor can be enabled or disabled by setting an environment 
variable. For information on how to enable or disable the PHIGS monitor, re- 
fer to the ESV Workstation Reference Manual [2 .0], chapter 1 , "ES/PEX," de- 
scription of OPEN XPHIGS, or the manual page for popenxphlgs. 

To set the path from which the PHIGS monitor is obtained, enter the fol- 
lowing command: 

setenv PEXAPIDIR directorypath 

where directory_path is the directory in which the PHIGS monitor is located. 
It is /usr/lib/x1 1/PEX by default. 

A client application cannot use both X input and PHIGS input. 
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PEX Line Features 



The 2.0 Release includes the capability to design and program an unlimited 
number of line patterns. Unlike previous releases, in which polyline patterns 
were limited to a predetermined type and number, a newly implemented GSE 
called Pgsejinepattern_mask allows you to create your own polyline 
types. For more information about Pgsejinepattern_mask, refer to the 
"ES/PEX" chapter in the ESV Workstation Reference Manual [2.0]. 



/usr/man/make.xman.sections 



sysadm 



This utility enables the manual browser client, xman, to find all of the manual 
pages on the system. It allows you to cleanup invocations of 
make.xman.sections from prior releases, or to back out completely and re- 
move all of the links and the mandesc file previously created. 

Running make. xman. sect! oris adds approximately 900 Kbytes to the 
/usr/man area. 

To execute the utility, follow the steps below: 

• Login as root 

• Type su bin 

• Type cd /usr/man 

(If Local Server, type cd /usr/diskless /usr/man) 

• Type . /make . xman . sections 

• Answer the prompts appropriately 

The system administration utility, sysadm, has been revised and enhanced to 
match the ESV system configuration and characteristics. 

sysadm is a menu driven utility that greatly eases several system 
administration tasks. The following five areas are involved: 

• file management, 

• machine management, 

• system setup, 

• tty management, 

• user management. 

Items such as backing up and restoring file systems, setting system time 
zone and date, and adding users are easily accomplished using sysadm. For 
a complete description of this utility, consult the manual page for sysadm. 
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XtSetDefauStAppContext 



A new routine called XtSetOefayltAppContext was added by Evans & Suth- 
erland to the Xt toolkit library. There is a manual page for this routine which 
contains a complete description of its functionality. 

The Motif widget set supplied by OSF relies on XI 1R3 compatibility rou- 
tines provided in the R4 Intrinsics. The release of the R4 Toolkit Intrinsics in- 
cluded the idea of application contexts, which did not exist in the R3 
Intrinsics. The R3 compatibility routines in R4 use the idea of a default appli- 
cation context to allow R3~style Intrinsics routines to be used in a backward 
compatible fashion. 

However, a program that is written to use the R4 Intrinsics may want to 
use a widget set (e.g., Motif) that uses R3 compatibility routines which re- 
quire the default application context to be initialized. The R4 Intrinsics, as re- 
leased by MIT, do not contain a function that explicitly initializes this default 
application context. It is initialized only within the R3-style initialization rou- 
tine Xtlnltlalize. 

The XtSetDefayitAppContext routine is provided for native R4 applica- 
tions that wish to use R3-oriented widget sets. Users should note that this rou- 
tine is not yet a part of the official MIT distribution and is non-portable at the 
source-code level. 
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PEXt Toolkit 



The PEXt (PEX Toolkit) library is new with the 2.0 Release, and it contains 
several convenience routines for X toolkit based PEX applications as well as 
providing a PHIGS workstation widget that can automate some of the tedium 
of handling exposure and resize events on a PHIGS workstation's window. 
The following manual pages describe the routines in the library: 

• Matrix convenience routines: 

PEXtBuildTran 
PEXtNonUniformScale 

PEXtRotate 
PEXtTransfate 

• Primitive convenience routines: 

PEXtCircfe 
PEXtCube ' 
PEXtCytincIer 
PEXtEII«pse2 
PEXtSphere 

• Utility routines: 

PBXtlnitialize 
PEXtOpenPEX 
PEXtRegisterConverters 
PEXtSanityCheck 

• Widgets: 

PEXtWorkstation 

The PEXt library developed from the observation that certain operations 

become common when writing PEX application code. For instance, the PEX 

API provides convenience routines for creating transformation matrices {e.g., 

BUILD TRANSFORMATION MATRIX 3, ROTATE, TRANSLATE, SCALE, 

etc.) and a routine for setting transformation matrices in the PHIGS viewing 

pipeline model (e.g., SET LOCAL TRANSFORMATION, 

SET GLOBAL TRANSFORMATION, etc.). A frequently encountered 

operation is to create a matrix using one of the convenience routines and 

immediately insert the matrix as a local transformation matrix: 

[ . . . ] 

{ 

Pvec3 translation; 
Pint PEXtError; 
Pmatrix3 m; 
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: f 

translation. delta_x =1.; 1 

translation. delta_y = 1 . ; 

trans lation.de It a_z = 1 . ; 

ptranslateS (&translation, SPEXtError, m) ; 

if (PEXtError) 

{ 

fprintf (stderr, "?unexpected PEX error %d!\n", 

PEXtError) ; 

exit(l); 

} 

pset_local__tran3 (m, PTYPE_POSTCONCAT) ; 
} 
[...] 

PEXt provides convenience routines to perform this common operation 
with a single procedure call: 

PEXtTranslateS ( 1 . , 1 . , 1 . , PTYPE_POSTCONCAT) ; 

The error code returned by the PEX API routines called by the PEXt li- 
brary is kept in the global variable PEXtError (described in the 
PEXtSanltyCheck manual page). A "sanity check" is performed after this 
variable is passed to any PEX API routine, and the library prints a message and 
exits when it encounters a non-zero value for the error code. These conve- 
nience routines provide simple mechanisms for performing common PEX op- 
erations. 

The second portion of PEXt is the PHIGS workstation widget, which is de- 
scribed fully in the manual page for PEXtWorkstation. The widget provides 
the basic mechanisms of a PHIGS workstation and provides callbacks for ex- 
pose and resize events. Simple management of exposure and resize events can 
also be performed without callbacks, providing commonly occurring behav- 
ior for these events. Refer to the manual for a description of the behaviors 
supported. 

The third portion of PEXt is a set of resource conversion routines that al- 
low PEX applications to specify resources having PEX data types {e.g., 
Ppoint3, Pvec3, etc.). The resource conversions and the valid string values 
are described in the manual page for PEXtRegisterConverters. 

This library evolved (and is evolving) out of common operations in real 
PEX programs, and suggestions for improvement and/or bugs should be sub- 
mitted to Evans & Sutherland. This is the first public release of this library, 
and it will be submitted to the X Consortium for inclusion in the contributed 
software distribution. 
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PAttach 

A change has been made in the parameter sent to PAttach which allows 
ES/PSX to be used more effectively with the Local Server option. When run- 
ning on a Local Server machine, it may be desirable to have the GSR applica- 
tion running on the SCPU while ES/PSX is running on the GCPU. The change 
to the PAttach parameter makes this possible. 

Prior to this change, the PAttach call accepted a string that was the name 
of the ES/PSX process to which it was attached. An optional comma (,) is 
now permitted in that string parameter. The comma is placed after the 
ES/PSX name, and is followed by the hostname on which the ES/PSX process 
is running. 

For example, to attach to an ES/PSX process named too which is running 
on the ESV Workstation named graph, the PAttach call would be: 

PAttach ( "f oo, graph" ) 

To attach to an unnamed ES/PSX process on graph, the PAttach call would 
be: 

PAttach (", graph") 

Note: The PAttach command identifies the port on 
the server host by issuing an rep command to 
copy a file from the server to the local host. 
The rep command requires that the local host 
be identified as a trusted host to the remote 
server. This is accomplished by updating the 
user's .rhosts file, or the system hosts.equiv 
file (see the volume 4 manual pages for more 
information). The Permission denied 
message is received if the rep command fails. 

CPK Renderings 

ES/PSX now can render CPK images with the same quality as is available on 
the PS390. This functionality is triggered by setting the sphere precision to 
zero with the following command: 

SEND FIX(O) TO <24>SHADINGENVIRONMENT; 

This is now the default sphere precision. 

With this sphere precision, CPK ignores the cylinder precision value giv- 
en on input <25> of SHADINGENVIRONMENT. Cylinder radius and two- 
tone control can still be manipulated by input <21> of 
SHADINGENVIRONMENT. 
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PSXENV f 

A new initial function instance was added: PSXENV. It works much like the 
PS390ENV function in that all of its inputs are constant inputs except for in- 
put <1>, which is used only to trigger the function. 

Inputs: 

<1> - trigger which accepts any data type to cause the function to run. 

<2> - constant which accepts an integer to specify the ES/PEX Marker type 
used in ES/PSX to display dots. 

The following ES/PEX marker types are currently supported: 

-6 : Octagon 
-5 : Inverted Triangle 
-4 : Square 
-3 : Triangle 

-2 : Dot (Faster than 1) This is the default 
-1 : Diamond 
: Asterisk 

1 : Dot (Higher Quality than -2) 
2 : Plus Sign 
3 : Asterisk 
4 : Circle 
5:X 

The application developer may want to change the marker type in or- 
der to make ES/PSX dots appear brighter, to give them a certain de- 
sired shape, or to get better performance. 

<3> - constant which accepts a real number to specify the scale factor for 
ES/PSX dots. The default is 0.25. 

When changing the dot type or the dot scale factor, the change effects all 
of the dots used in the ES/PSX display structure. 

ES/PSX Function Keys and Dial Labels 

The ES/PSX Function Keys and Dial Labels Soft Devices are now outlined 
slightly differently than in previously releases, and the default background 
color of the top window has been changed from white to black. Almost all of 
these appearance attributes can be changed in the user's .Xdefaults file. See 
appendix G of the ES/PSX documentation for details on how to do this. 
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ES/PSX Full Screen Monoscopic Mode 

A new screen mode format is available in which ES/PSX will take over the 
entire ES V screen. This could be useful when wanting to get a photograph of 
the ES/PSX window but not the other windows on the screen. This is enabled 
with the commands: 

SEND FIX (-2) to <5>PS390ENV; 
SEND TRUE TO <1>PS390ENV; 

Another command was added which allows you to change back to the pre- 
vious screen mode (either Monoscopic or one of the Stereo Modes). After this 
mode has been entered once, it is possible to toggle in and out of this mode 
by typing the following: 

SEND FIX(-l) to <5>PS390ENV; 
SEND TRUE TO <1>PS390ENV; 

Alternately, you can toggle in and out of this mode with a special hot-key 
sequence; press the CONTROL and SHIFT keys simultaneously, then press all 
three mouse buttons simultaneously. 

Physical I/O 

The Physical I/O capability is now supported, and change pages that describe 
and define it are contained in appendix B. 
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AVS Functionality ( 

Product Overview 

The Application Visualization System (AVS) is an interactive environment 
which gives users the ability to use advanced computer graphics and imaging 
techniques without graphics programming. It allows users to construct appli- 
cations that transform their computational code into meaningful graphics. 
AVS models the iterative, exploratory approach of scientists, and provides in- 
teractive visual feedback. With AVS, users can: 

• Quickly visualize geometric, image, and volume data sets; 

• Interactively construct and execute a processing network using a vi- 
sual network editor; 

• Easily connect user computational programs to the processing net- 
work for realtime, interactive processing and visualization; and 

• Build discipline-specific visualization applications. 
Features Added in the 2.0 Release 

Transparency 

Transparency is now supported through the Edit Property menu. 

"Multi-pass" Traversal Mode 

To support the added functionality of transparency and antialiased lines on 
top of polygons, another Z-buffering mode was added to the ZBUFFER button 
in the Cameras menu. The ZBUFFER radio button is now a tri-state button 
which supports the following modes: 

• Gray Ball - No Z-buffering 

Indicates that Z-buffering is turned off. Used for scenes containing 
only lines and no polygons. 

• Dark Blue Ball - Z-buffering 

Indicates that Z-buffering is turned on. Used for scenes containing 
shaded polygons, spheres, and transparency. If you use transparency 
in this mode, you should read all transparent objects into the 
Geometry Viewer after all the opaque objects have been read. This 
will allow for the correct transparency calculation and for optimum 
performance. 
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• Light Blue Ball - Multi-pass Traversal Z-buffering 

Indicates that multi-pass traversal Z-buffering is turned on. This mode 
will create the best possible picture but with some sacrifice in 
performance. This mode will create a picture with nice transparency 
and antialiased lines on top of shaded polygons, regardless of the 
order in which objects have been loaded into the Geometry Viewer. 

Unsupported Features 

The following is a list of the unsupported or not-yet ported features and func- 
tions of AVS. 

Unsupported Peripherals 

• Control dials 

• Spaceball 
Unsupported Modules 

• Transform pixmap 

• Alpha blend 
Unsupported Functionality 

• Texture mapping 

• Phong shading 

New AVS Usage 

A command line option to choose the type of sphere primitive is available by 
using the -sphere option when starting AVS. 

The default sphere primitive (without the -sphere option) is a triangle 
strip generated by AVS. This primitive is best used when more interactive 
updates are desired. 

The sphere primitive generated with the -sphere option will use the 
PHIGS GDP primitive in the hardware. This primitive is best used when the 
creation time is important; i.e., the time it takes to create and delete the sphere 
primitive is less than when using the triangle strip primitive. For example, a 
co-routine module that would create spheres would perform better by using 
the -sphere option. The second advantage using this primitive is the amount 
of memory it requires. Since the application stores these primitives as single 
spheres (as opposed to triangle strips, as is the case for the default sphere), 
considerably less memory is consumed. 
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alimentation Corrections 



This is a list of the unsupported items and the pages on which they are found 
in the AVS User's Guide provided by Stardent. 

Chapter 4 

• Pg. 4-1 — under "Geometric Techniques," bubble viz is not support- 
ed. 

• Pg. 4-1 through 2 — under "Volume Rendering," alpha blend and 
shaded alpha blend are not supported. 



Chapter 5 



Chapter 7 



Pg. 5-7 — under "Function Key Usage," F4 - Transform Map is not 
supported. 

Pg. 5-7 — Transform textures are not supported. 

Pg. 5-8 — Dial box and Spaceball are not supported. 

Pg. 5-9 — under "Geometric Viewer," edit texture, lines, and Phong 
are not supported. 

Pg. 5-14 — Edit texture is not supported. 

Pg. 5-15 — Lines and Phong shading are not supported. 

Pg. 5-20 — "Depthcue Lines" should be just "Depthcue." This depth 
cues all objects in the camera, not just lines. 

Pg. 5-20 — "Z-Buffer Lines" should be just "Z-Buffer." This Z buff- 
ers all objects in the camera, not just lines. 

Pg. 5-23 — Font Selection Submenu has only Fontl and Font2. It 
does not have Courier, Helvetica, Schoolbook, Times, Charter, and 
Symbol fonts. Also there are no bold or italic fonts. 

Pg. 5-24 — Dropshadow is not supported. 

Pg. 5-24 — Add "Stroke" under Label Attributes Submenu. Stroke is 
3D text and can be scaled just as any object. Annotation text is used 
when Stroke is turned off. 



Pg. 7-8 through 10 — Alpha blend is not supported. 
Pg. 101 — Transform pixmap is not supported. 
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Appendix A 

• Pg. A-6 — Item 20 should say mandril.x instead of stardent.x. 

• Pg. A-7 — Stardent image should be replaced by Mandril image. 

• Pg. A-25 through 28 — Items 73 through 79 are not supported. 
Appendix B 

• Pg. B-5 through 6 — Any references to Lines are not supported. 

• Pg. B- 10 through 11 — Any references to Lines or Phong are not sup- 



ported. 
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New Options in the 2.0 Release 



Local Server 



Spaceball 



Button Box 



The Local Server consists of the following two cards: 

• Server CPU Card 

• DPR Card 

The Local Server provides the ES V Workstation user with a second, ful- 
ly-functional CPU Card called the Server CPU. The Server CPU supports all 
ES V Workstation hardware and software products supported by the standard 
CPU (called the Graphics CPU), with the exception of products that require 
the CPU to be directly connected to the ESV Workstation graphics hardware. 
The Local Server offers the ESV Workstation user a way to purchase an in- 
expensive network compute/file server. 

The Local Server software is included in the 2.0 Release. For additional 
information, refer to chapter 9, "Local Server," in the ESV Workstation Us- 
er's Manual [2.0], 



Spaceball is an optional interactive device, consisting of a stationary ball 
which senses applied force and torque. Eight programmable buttons are locat- 
ed on the upper face, which can be used as function keys, and another pro- 
grammable button is located on the front of the ball, which can be used as a 
pick button. 

Spaceball has six degrees of freedom. By pushing and twisting the sta- 
tionary ball, Spaceball simultaneously senses the forces along, and the 
torques around, the x,y,z axes of its coordinate system. These six parameters 
are processed by Spaceball and output as numeric vectors and matrices. They 
can be used to control any function you specify. 

Spaceball can be implemented through ES/PSX or X. For additional in- 
formation refer to the following document, which is shipped with the option: 
Spaceball User's Manual [2.0] (E&S #517941-201). 



The Function Button Box unit is an optional interactive device that gives an 
expanded capability for program selection by providing 32 programmable 
function buttons in addition to the 12 function keys on the keyboard. 
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Data Shuttle 

The Data Shuttle facilitates the removal of two disk drives without discon- 
necting any wires or cables. The Data Shuttle provides shock protection and 
electrostatic discharge protection (ESD) for the disk drives. The disk drives 
are mounted in individual canisters which slide easily in and out of the chas- 
sis. The E&S part number for this option is 220050-100. 
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2. Known Bugs in the 2.0 Release 

This chapter describes bugs known to be in the 2.0 Release. 

Note: For additional information about operating 
system and compiler bugs, refer to the 
MIPS Release Notes, which will be found on- 
line in the /usr/pkg/rn directory. 

Bugs are organized into six categories within this chapter as follows: 

• System bugs 

• ES/os bugs 

• ES/PSX bugs 

• ES/PEX bugs 

• X Window System bugs 

• OSF/Motif bugs 

System Bugs 

1.3 X Server 

If you type xinit on a machine where an X server is already running, the initial 
X server hangs. The CTRL-ALT-BREAK key sequence will not kill it. 

1.4 Bad Broadcast Address 

On the ES V Workstation, the variable portion of the default broadcast address 
contains 0s (zeros). If the default broadcast address is used, it may result in 
portmap generating an mf ree panic. To prevent this from happening, you 
should set the broadcast address explicitly in /etc/local_hostname. 

1.7 ES/Dnet Remote DCL/Shell Command 

Remote DCL/shell commands won't allow you to specify a file without an 
extension. You must rename files to a name with an extension before copy- 
ing. 
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ES/osBugs 

2.3 Line Editing 

There is a bug in the MIPS documentation regarding line editing. After start- 
ing and killing the X server, the parent session is automatically logged off. 
The problem disappears when line editing is not set in the C- shell. 

2.6 Server Cleanup 

If the PEX server crashes, you may have to clean up the system shared mem- 
ory, and semaphores. To clean up the active shared memory and semaphores, 
if attempting to start the Xserver fails, do the following: 

1) Login as root. 

2) Execute the shell command: ipcs. 

3) Remove them with the shell command: 

ipcrm -s {Semaphore ID} -m {Shared Memory ID} 

4) The /tmp directory should also be cleaned out by removing all the files 
with the shell command: rm /tmp/*. 

2.9 find Command Stops on /usr/lib/cron/HFO| 

The BSD version of the find command will search a periodically updated da- 
tabase for a requested file instead of searching the directory hierarchy direct- 
ly. This can result in a much improved response time when you are looking 
for a specific file. 

In order to periodically update this database, an entry in the cron table is 
made to run the sh(1) script /usr/lib/find/updatedb once a week. This file 
looks in a set of search paths (excluding NFS mounted directories) and 
creates the appropriate database. 

However, this database is incomplete because it doesn't contain files local 
to the machine. The find command gets an error on the file 
/usr/lib/cron/FIFO|. The error reported is: 

Couldn't find mount point for FIFO 

To avoid the problem, use the explicit path name form of the find 
command. 

2.11 Pascal Compiler Initialization Crash 

A Pascal compiler bug causes a crash during initialization due to incorrectly 
generated code attempting to clear a local variable. 

If a local variable is defined which is a record consisting of a 255-byte 
array and a two-byte integer, the compiler generates incorrect code to clear 
the array. A bus error occurs. 
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The following is C code which calls the offending Pascal code: 

*/ 

main () 

{ 

printfC'if there is no following message, it crashed\n") ; 

bug(); 

printf ("didn't crash\n") ; 
} 

The following is the offending Pascal code: 

*/ 

TYPE 

Intl6 = -32768..32767; { 16-bit integer } 
Bytespell = ARRAY [ 1..255 ] OF char; 
stringtype = RECORD { the offending record description } 
chars : Bytespell; 
len : Intl6; 
END; 
PROCEDURE bug; 
VAR 

temp : Stringtype; 

PROCEDURE copy_str ( stri : Bytespell; VAR stro : Stringtype; 

len : Integer) ; 
VAR 

i : Integer; 
BEGIN 

FOR i := 1 TO len DO 

stro. chars [i] := stri[i]; 
END; 

BEGIN 

copy_str( , so far so good' , temp, 14); 

writeln (temp. chars) ; 
END; 

2.13 FORTRAN Parameter Declaration 

The FORTRAN PARAMETER (epsilon = ^cbOOOOOOOOOOOOO'x) fails. De- 
claring an epsilon variable using a literal hex value such as 
PARAMETER (epsilon = 'ScbOOOOOOOOOOOOO'x) fails to produce valid re- 
sults when multiplied by a floating point number. This problem does not oc- 
cur if the variable assignment is not made as PARAMETER. 

Try to avoid using PARAMETER declaration for this type of variable. 
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2.14 xdm Log File f 

The X display manager xdm creates a log file /usr/tmp/xdm-errors.This file 
grows each time you log in and out of the system via xdm.The only way to 
safely remove this file is to reboot the system. At this time, the old file will 
be removed and a new one will be opened. It is recommended that you reboot 
the system periodically so as to not allow the file to grow too large. 
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ES/PSXBugs 

3.2 Unsupported GSRs 

The following GSRs are not supported in ES/PSX (in addition to those already 
noted in the "Porting from the PS 390" chapter in the ES/PSX User's Manu- 
al): PPutGX, PSndRStr, PDelim, PLoad, PSavBeg, and PSavEnd. 

3.14 Dial Box Label Characters 

The = (equals) character cannot be set into the dial box label. 

3.23 Missing Pixels in Stereo 

The two pixels in the left-most boundary of the low-resolution and mixed res- 
olution stereo screen are not seen. The two pixels in the right-most boundary 
are not seen in mixed resolution stereo. If a line is drawn vertically at these 
extremities, it is not seen. 

3.24 Gap at Top of ES/PSX Window 

A border drawn around an ES/PSX window from -1 : 1 in x ,y will leave a small 
(approximately 1 to 2 pixels) gap at the top of the X window between the 
stroked box and the X window border. 

3.25 PSX Warning Messages 

The warning initial function is not set the same in PSX and the PS 390. On the 
PS390, warning messages are turned off at bootup. In PSX, the warning mes- 
sages are on by default. To avoid getting warning messages, enter the follow- 
ing command at the keyboard: 

Send false to <l>warning; 

or from your site.dat file: 

Send false to <l>warningl; 
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ES/PEX Bugs 

4.5 PHIGS Functions Without Errors 

The PHIGS and PHIGS PLUS functions that are not supported in this release 
do not produce error messages. For a list of the supported and unsupported 
functions, refer to the "ES/PEX" chapter of the ESV Workstation Reference 
Manual. 

4.8 pinqdynstruct 

Page 462 of the SunPHIGS LI Reference Manual lists the function 
pinqdynstruct. It uses as a reference the structure Pmodstruct. The element 
priority is listed for the C structure, but not for the FORTRAN parameters. The 
priority element is not in the phigs.h file and should be ignored. 

4.10 ddpex 

Errors returned from ddpex are not consistent. They have just recently been 
defined by the PEX SI project, and this release does not incorporate these def- 
initions. 

4.17 Invalid Color Type 

Elements with invalid color types produce errors. Currently, the system 
checks all elements that contain colors for unsupported color types. If an ele- 
ment with an unsupported color type is found, the element is rejected and an 
error is issued. This is different from the proposed PHIGS PLUS standard, 
which states that the correct action is to build the element, detect the bad color 
type during traversal, then use the default color. 

4.18 RGB Values 

RGB values need to be clamped to reasonable ranges (0.0 to 1.0) when the cli- 
ent program supplies out-of-range data. This is not done currently, and RGB 
values outside the range 0.0 to 1.0 have unpredictable results. 

4.20 Workstations on Multiple Servers 

You cannot open workstations on multiple servers. When OPEN 
WORKSTATION is called, and the server to which the connection is being 
made is not the same as the default server sent to OPEN PEX, an X error oc- 
curs, and the workstation is not opened. 

To work around this problem, you can call XGetWindowAttributes on 
the workstation window before calling OPEN WORKSTATION. This allows 
the OPEN WORKSTATION to complete. 
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4.25 Black Polygons Visible With Black Background 

With a black background color set, black lines, markers and text are all indis- 
cernible. Black polygons, however, are more a charcoal gray color and are 
still visible. 

4.26 DeleteStructures Fails 

Under certain conditions a PEX bug using labels and delete structure causes 
DeleteStructures to fail. 

4.27 Quad Meshes With Vertex and Facet Normals 

Certain sizes of quad meshes with vertex and facet normals are not displayed 
correctly. The last row is incorrect. If the facet normals are not set for the 
mesh, it is displayed correctly. 

4.28 PEX Structure ID Size 

Unpredictable results occur if the PEX structure ID is larger than 64K. 

4.29 RETRIEVE STRUCTURES 

The archive retrieval function RETRIEVE STRUCTURES can hang. When 
the routine is called, and the list of structures to retrieve is not in sequence, 
the routine may not return. 

4.30 INQUIRE PICK DEVICE STATE 3 

The value in the lnit_plck.depth field which is returned when 
INQUIRE PICK DEVICE STATE 3 is called is not correct. Also, if you are us- 
ing the 1.3 thin layer, this procedure should not be used at all, because the 
buffer size which is returned is incorrect and may cause unpredictable behav- 
ior. 

4.31 INQUIRE DEFAULT LOCATOR DEVICE DATA 3 

INQUIRE DEFAULT LOCATOR DEVICE DATA 3 returns an error. A call to 
this routine may generate a bad device error (error 250) even though a valid 
locater device is given. 

4.32 1.3 Thin Layer pinqelemcontent 

The 1.3 thin layer pinqelemcontent routine does not work. It produces a seg- 
mentation fault. There is a workaround for this bug. If no structure is open, 
substitute the call to pinqelemcontent with the following: 

popenstruct (struct) ; 

psetelemptr (elem) ; 

pinqcurelemcontent (size, error, buffer, total_size, data) ; 
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If another structure is open, you must first close that structure before calling I 

the above routines. 

4.33 INQUIRE HLHSR MODE 

This inquiry routine may incorrectly return an error, even when no error oc- 
cured. If the error indicator is 0, the data is correct. Otherwise, the returned 
values may be incorrect. 

4.34 Cylinder GDP 

If a Cylinder GDP with indexed colors contains a cylinder list that is too large, 
the server will hang. To prevent this, make sure that no cylinder list which 
uses indexed colors contains more than 33 endpoints. 

4.35 Opening Multiple Server Connections 

The PHIGS libraries supplied with the 2.0 release contain a fundamental bug 
that prohibits PHIGS clients from having more than one connection to a serv- 
er, including multiple connections to different servers. Attempts to establish 
more than one connection will result in one of the X servers aborting when- 
ever an execute structure element is created. 

Multiple connections can be established in several ways, some of which 
are subtle. Here are a couple of examples. 

• If you call popenjahigs, then open a workstation of type 
phigs_wsjype__x_drawable, two connections are created. Since 
popen_phigs was used instead of popenjcphigs, a connection was 
created while opening PHIGS and another is established by the 
XOpenDisplay call that is required prior to opening the workstation. 

• If you call popen_phigs and then open a workstation of type 
phigs__ws_typejc_Jool with a connection id string that is not the 
same as the one used to set the DISPLAY environment variable, two 
connections are created. The best approach to opening 
phlgs_ws__type_x_tool workstations is to always pass a NULL 
string for the connection id. This will cause popenws to use the con- 
nection established by the popen_phigs call. 

4.36 SET EDGETYPE 

Setting the edgetype to something other than solid in SET EDGETYPE will 
cause unpredictable visual effects. 

4.37 SET FACE DISTINGUISHING MODE 

If you set the back face distinguishing mode to yes in 

SET FACE DISTINGUISHING MODE, and you shade a back facing polygon, 

the polygon will appear black. 
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X Window System Bugs 

5.8 DeviceMotlon Extension Events 

DeviceMotion extension events for dials do not propagate through the win- 
dow hierarchy as documented in the XI 1 Input Extension Library Specifica- 
tion. For a finite number of subwindows, you can request the event for each 
of the windows. 

5.9 Xgetlmage 

Calls to XGetlmage with large portions of the screen take a long time to com- 
plete. 

5.10 XSync 

When the device focus is set to the tablet, calls to XSync may cause a bus er- 
ror. When the device focus is set to the dials, calls to XSync may cause the X 
Server to crash. 

5.11 XGrabDeviceButton 

XGrabDevlceButton returns a NOMATCH error ("device does not support 
input class BUTTONS") when you try to grab a tablet button. 

5.12 XQueryDeviceSfate 

XQueryDevieeState kills the server when you ask for information about the 
dials. 

5.13 Running a Large Number of Clients 

If you run a large number of clients (> 4,000), some of the clients may fail. 

5.14 Dials 

When constantly sending dial labels, and turning 3 or more knobs at the same 
time, the dial box may get confused and blank out labels and make other mis- 
takes. Avoid sending a large number of label updates when simultaneous ro- 
tation of dials is needed. 

5.16 XAIIowEvents 

XAIIowEvenfs does not allow events to be sent to the client that has grabbed 
the keyboard or the mouse. 

5.18 XFreePC 

XFreePC returns Colour Type error when it is called: 

X Error of failed request: Colour Type Error — device does 

not support the specified color typ 

Major opcode of failed request: 135 (ESPickExtension) 
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Minor opcode of failed request: 4 (X_FreePC) 
Value OxlcOOOOl 

5.20 Keyclick Doesn't Work 



c 



Turning keyclick on and off through xset never produces a key click noise, 
even though the keyboard supports it. 

5.21 Cut Buffer Drops Characters 

When several lines (more than 10) are put into the X server's cut buffer, then 
are pasted into another Emacs window, characters are frequently dropped if 
Emacs is performing an autosave. 

5.22 xsetroot -cursor Fails 

If a bitmap greater than 64 x 64 pixels is used as the root window cursor using 
xsetroot -cursor bitmap bitmap, the bottom and right segments of the cursor 
> pixel 64 are truncated in the display. 

5.23 XGetDeviceDontPropagateList and XChangeDeviceDontPropagateLIst 

XGetDeviceDontPropagateList always returns a count of events not to 
propagate, and XChangeDeviceDontPropagateLIst doesn't appear to 
change this. 

Also, selecting events for the window in which you are attempting to use | 

XChangeDeviceDontPropagateLIst creates an error. V 

5.24 XtUnmapWidget Fails 

XtUnmapWidget fails if it is called immediately after XtMapWidget. 

In the following sequence of calls: 

XtMapWidget (topLevel) ; 

XFlush ( XtDisplay (topLevel ) ); 

XtUnmapWidget (topLevel) ; 

XFlush ( XtDisplay (topLevel ) ) ; 

the unmap does not work. If a sleep(1) is placed before the unmap, it works. 

5.25 Ico Leaves Trails 

When you run Ico with the flags -Ob] octa -Iw 10, which draws an octahe- 
dron with a 10-pixel linewidth, the moving object leaves trails behind. 

5.26 XLKEYBOARD 

XUCEYBOARD is not declared in Xl.h for XListlnputDevices. Compilation 
returns the error XI KEYBOARD undefined. 



C 
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5.27 Picking in Perspective Projection 

With the projection specified as perspective, a picking program gets zeroes 
for the model coordinates when a primitive is picked. If the projection is 
changed to parallel, the model coordinates are returned correctly. 

This occurs because the perspective matrix is non-invertible, making it 
impossible to compute a 3D pick point. There is a flag for this condition 
which can be checked. 

The typical cause for the perspective matrix to be non-invertible is putting 
the projection reference point on the front clipping plane. This creates a 
matrix with zeroes in the column. That matrix is non-invertible making it 
impossible to return a model space pick point. 

5.28 xterm 

xterm won't work with VMS TDMS. When TDMS queries as to the terminal 
type, xterm does not reply. 

5.29 XGrabServer 

The combination of a client program calling XGrabServer and a bus error, 
locks up the server. Here is a sample program: 

main() { 

Display *dpy; 

unsigned long used[2], i=0xffll00; 

dpy=XOpenDisplay ( * M ) ; 

XGrabServer (dpy) ; 

XSync(dpy, 1); /*freezes with an X call*/ 

used[i]=l; /*force bus error*/ 
XUngrabServer (dpy) ; 

XCloseDisplay (dpy) ; 
} 

5.31 Turning the Bell on/off 

Using xset to turn on/off the bell (xset b off, xset b on) has no effect; the 
bell always rings. 

5.35 Overlay Planes 

XGetlmage and XPutlmage do not work with overlay planes under all con- 
ditions. 

5.36 xman Crashes in XCreateWindow 

xman will crash with the error 'cannot do bold and italics' on manual pages 
that attempt to do bold and italics at the same time. One example of this is the 
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XCreateWindow manual page. If you scroll down through it, xman will die C 

at the certain point that it tries to do both bold and italics. 

5.37 xman Segmentation Faults 

xman has segmentation faults with A m or A d in the help screen. Under xman, 
in a manual-page or directory window, the key presses CONTROL-d and 
CONTROL-m will display the directory or the manual page, respectively. 
However, if you press one of these key combinations while the cursor is in 
the help window, xman will produce a segmentation fault. 



( 



c 



2-12 2.0 Release Notes 



Known Bugs in the 2.0 Release 



OSF/Motif Bugs 



With the ES/os 2.0 release comes the OSF/Motif Revision 1.1.1 which uses 
Version 11, Release 4 of the X Windows System, including the XI 1R4 X 
Toolkit Intrinsics. 

On-line release notes for OSF/Motif 1.1.1 can be found in 
/usr/pkg/rm/motif. 

6.2 OSF/Motif Reference Manual 

On page 38 (and many other pages), the constant named XmN insert Position 
does not exist. This is a software bug, but, until it is fixed, applications can 
use the string "insertPosition" (quotes included) in its place. 

On page 404, in the middle of the page, there is a constant referred to as 
XmText. The name of this constant should be XmTextWidget. 

On page 407, in the middle of the page, there is a constant referred to as 
XmNinsertionPointVisible. The name of this constant should be 
XmNcursorPositionVisible. 

On page 410, near the bottom of the page, there is a constant referred to 
as XmGR_MOVING_TEXT_CURSOR. The name of this constant should be 
XmGR_MOVINGJNSERT_CURSOR. 

6.27 PushButtonGadgets 

When the height and width attributes of PushButtonGadgets (with bulletin 
board parent) are set at creation of the gadgets, they are not maintained if the 
gadget is later moved to a new position. 

For example, if PushButtonGadgets are positioned at 0,0 on creation 
and subsequently moved to new x,y positions by means of XtSetArg and 
XtSetValues, they position correctly but their height and width are no longer 
correct. 

This can be worked around by creating the gadget with no arguments set, 
then setting all arguments (including size, position etc.) for the gadget after 
creation using XtSetArg and XtSetValues. Then don't reposition them again. 
Another possible workaround is to re-parent the gadget. 

6.28 Motif Doesn't Pass Pointer to Event 

When a resize callback is added for a drawing area widget, no pointer to the 
event is passed into the callback in the callback structure. The third parameter 
passed to the callback routine should be a structure defined the following 

way: 

typedef struct { 
int reason; 
XEvent *event ; 
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Window window; I 

} XmDrawingAreaCallbackStruct; 

The window and reason are there, but the pointer to the event is NIL. To 
get the information contained in the event, you can call 
XGetWindowAttributes. 

6.29 Popup Menu Causes Fault 

Popup menu as a child of top-level shell causes a fault. When creating a pop- 
up menu as a child of the widget returned by XtApplnitialize (i.e., as a top- 
level shell widget), an application gets a segmentation fault when attempting 
to manage the popup menu. 

If the popup menu is created as a child of a manager widget (or any 
widget that inherits behavior from the manager widget class, such as a row 
column) then it works fine. 

6.30 Motif XmStringCompare 

In some cases, XmStringCompare does not return a correct comparison re- 
sult. To avoid this problem, use X;n St ring Byte Com pare to compare strings. 



6.31 Button State Info Problem 

During testing, a check on the valid state info for a button window sometimes 
returns non-expected data, failing the test. 

6.32 Bitmap Failures 

A number of Motif tests are designed to bring up bitmaps, but fail to do so. 
The bitmaps will come up in certain sections of the tests, but not others. Some 
functions will allow bitmaps to work, others won't. 
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3. Bugs Fixed in the 2.0 Release 

This chapter lists bugs reported in previous releases that have been fixed in 
the 2.0 Release, as well as bugs not previously reported but fixed for this re- 
lease. 

Bugs are organized into six categories within this chapter as follows: 

System bugs 

ES/os bugs 

ES/PSXbugs 

ES/PEX bugs 

X Window System bugs 

OSF/Motif bugs 

System Bugs Fixed 

Structure Memory 

If a process exhausts structure memory, the PEX server may crash without no- 
tification. Structure memory should be set to be one-half of the total system 
memory. For more information, refer to the "Customizing the System" chap- 
ter in the ESV Workstation User's Manual 

Yellow Pages 

Yellow Pages does not work properly in ES/os. 

18 x 25 Data Tablet Mapping 

When the large data tablet is set to be the core pointer the cursor/screen map- 
ping is incorrect. The x_root element in the event structure is mapped cor- 
rectly, but the y_joot element is wrong. The range in v seems to be from to 
740, when it should be to 1023 

6x9 Data Tablet 

The 6x9 data tablet doesn't generate button change events unless the puck po- 
sition changes as well. You only get an event when you move the increment 
amount, regardless of button changes. 

ES/Dnet Can't Read Password 

When logging onto the ESV from a VAX, after entering your login name the 
system returns: 

Sorry, can't read your password. 
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This occurs immediately after installing the operating system, C 

occasionally after rebooting ES V, and when ES/Dnet has been running a long 
time. You should stop and restart ES/Dnet. This may or may not be a 
permanent fix. 



ES/Dnet 



When ES/Dnet runs, it can get into a state in which it uses 80-90% of the CPU. 
This makes everything else run very slowly. It is reported that you can tem- 
porarily correct the problem by bringing down ES/Dnet and restarting it. This 
condition occurs mainly when the system has been sitting idle for a long time. 
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ES/os Bugs Fixed 

Help Facility /usr/lib/help/glossary 

The help facility /usr/lib/help/glossary is not found. If you type in 

$ help 
then follow the menu option to get the glossary, the following error message 
comes up: 

sh: /usr/lib/help/glossary: not found 

indent 

When you run indent you get a core dump and an empty file. 

Id Crash 

Id crashes and dies under certain conditions. When compiling the test suite 
for mwm an error occurs on the first compilation. 

usIeepQ 

The system function usIeepQ is listed in the on-line manual pages, but it is 
not in any of the system libraries. An equivalent function can be implemented 
using setitimerQ. 

nm Command 

The nm command doesn't work with some libraries. 

bcopy has System V Semantics 

The bcopy provided in the BSD library has System V semantics. It does not 
allow for overlapping copies. 

dbx Dies 

When using dbx via an rlogin session from a non-ESV Workstation, the de- 
bugger causes the rlogin session to terminate abnormally. 

rlogin and recall Incompatible 

When a process has made an rlogin to an ES V Workstation from a Sun Work- 
station, and you type the ! ! command, the process immediately terminates and 
the login session closes. 

vmstat and iostat 

In the ES/os, vmstat and iostat don't work correctly. 
vmstat produces the following message: 

nscsi undefined in system 

iostat produces the following message: 

scsiiotime not found in /unix namelist 
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export 

The manual page for exports indicates that directories, subdirectories and 
even files may be exported via NFS. If /etc/exports contalns-mn entry for 
something other than a file system, thefeceiving machine gets the message 
access denied when trying to mount the imported directory or file. 

yacc Doesn't Allocate Enough States 

You get an error when you have more than 750 states because yacc was made 
without -Dmips defined. This keeps -DEXTRA_HUGE undefined which 
forces yacc to only allocate 750 states. 

stty Command Does Not Work on Redirect 

The stty command should be able to redirect requested tty settings to a line 
other than the currently logged in tty when used as follows: 

- /bin/stty [setting] < /dev/tty3 
-/bsd43/bin/stty [setting] > /dev/tty3 
The above commands should set the requested default(s) for tty3. This is im- 
portant if the tty line goes to a "dumb" device that requires certain defaults, 
like -ixany, but is not able to set them interactively. 

The 1.3 stty commands do modify the defaults for the specified tty, but the 
original defaults are restored as soon as the stty command exits. 

sendmail.nis Fails 

sendmail.nls fails with large alias lists due to small buffers in the send mail 
process. These buffers have been increased dramatically. 
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ES/PSX Bugs Fixed 

Hostnames Longer than 14 Characters 

In previous releases, ES/PSX would crash if it were run on hosts with a local 
hostname longer than 14 characters. This problem has been fixed in the 2.0 
release. ES/PSX applications must be relinked with Release 2.0 GSR libraries 
if they are to be run on hosts with names longer than 14 characters. 

Abort of psxcommand 

When running psxcommand, aborting with A C or by other methods may 
leave the terminal in a state that it may not echo. Users should exit 
psxcommand as via the escape sequence, which is "@." by default. 

Rendering Spheres in CPK 

If you run dynamic CPK with low precision spheres, rotate the spheres with 
their poles parallel to the monitor screen, and move the spheres a short dis- 
tance, horizontal lines may flash out of the spheres. 

CPK Specular Highlights 

When displaying a CPK model in ES/PSX with a high precision value and the 
terminal emulator turned on, movement of the cursor across the screen may 
cause the specular highlights to blink. 

CPK Spheres Clipped 

In ES/PSX, spheres and lines with z positions that cause them to reside in the 
back half of the CPK window are clipped and not seen. 

CPK Renderings Inverted in z 

In ES/PSX, some CPK renderings may be inverted in z. 

Turning Off the Display When Rendering 

When a rendering is done on the PS 390, the display is turned off by sending 
the equivalent of a fix(l) to TURNONDISPLAY, which turns the wireframe 
display off. This prevents stenciling over the static image on the PS 390. This 
feature has been implemented in ES/PSX. 

READASCII May Crash ES/PSX 

Sending a filename to input <1> of a F:READDISK function can occasionally 
cause ES/PSX to immediately abort with an Exit 1 1 error message. Thus, 
sending to the initial function instances READASCII and READBINARY may 
cause an immediate abort of ES/PSX. 
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DELETE STRUCTURE May Crash ES/PSX 

Using the DELETE STRUCTURE command may crash ES/PSX. The prob- 
lem occurs when a Set node in the structure that is being deleted is empty. 

Multiple CPK Processes 

If you are running multiple ES/PSX processes, do not run CPK in more than 
one. Doing so may cause unpredictable behavior, including the possibility of 
crashing the X server. 

Set Nodes in a Structure 

If you have a Set node under another Set node, which was created in 
OPTIMIZE STRUCTURE mode and which does not require the state to be 
saved, the X server will hang. 

ES/PSX xmenu 

When the xmenu window has root as its parent (that is, it is not under the 
'top' window), it has a few problems: 

1) Doesn't display the word Shell upon bootup, but does if you move the 
pointer to the xmenu window. 

2) Doesn't display any of the current states until the pointer is in the xmenu 
window. 

3) Can't use the keyboard to get into Shell mode. You can click on the 
xmenu to get into this mode. 

4) Clicking on Keyboard lags one click behind. 

5) Term and Graph seem to lag one mouse click behind, slightly differently 
than Keyboard. 

SET DISPLAY 

Sending TRUE or FALSE to the code created by the SET DISPLAY command 
does not make changes to what is displayed. 

Clock Functions 

The clock functions, namely the CLFRAMES and CLTICKS functions, could 
be triggered to run in 1 tick or frame, but might actually run immediately in- 
stead of waiting for that time. 

Keyboard/Term/Graph Data 

If the parent of the xmenu window was the root window, the display of the 
Keyboard/Term/Graph data was delayed. 
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Clipped Items Still Pickable 

Molecular structures which are clipped out in z and are not visible can still be 
picked in ES/PSX-FRODO. This has been fixed. 
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ES/PEX Bugs Fixed 

Back/Front Area Properties 



c 



With FACE DISTINGUISH MODE on and different properties set for the back 
and front area properties, the image will have the same properties for both. 

ES/PEX Polygon Rendering with ES/PSX 

When you bring up an ES/PEX window running the "sponge" program in 
ES/PSX, any dynamics applied to the ES/PEX model cause the specular high- 
lights to "wink" or vary in diameter on the object. 

pset_edgetype 

Calls to pset__edgetype with any types other than PSOLID still cause solid 
edges to be drawn. 

Broken pdel_elems labels 

If pdel_elems_labels is called to delete elements between labels, and there 
are no elements, an attempt is made to immediately insert elements, and the 
pointer gets lost. 

pfill__area__set3 

pflll_area_set3 that has edge data does not draw the edges as expected. It | 

draws the edges assuming the first edge ends at vertex 1 (the edge between V 

the last vertex and the first vertex). 

Clipping Causes Bad Model and Screen Points 

Clipping causes bad model and screen points on a pick. The points that are 
returned on a pick are incorrect. 

PHIGS Traversal State 

According to the ANSI standard, colors for PHIGS PLUS attributes should be 
initialized to type INDEXED and value 1. These attributes are initialized to 
type RGB and value WHITE. This will effect the behavior of programs that 
change the value of color LUT entry 1 and expect to see their default colors 
change. This affects the following attributes: polyline colour, polymarker 
colour, text colour, Interior colour, back interior colour, specular 
colourback, specular colour, and edge colour. 

InquireWkslnfo 

InquireWkslnfo returns spurious information for the current values of 
HLHSR mode, NPC subvolume, and workstation viewport. 
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EMPTY STRUCTURE and DELETE STRUCTURE 

Calling EMPTY STRUCTURE or DELETE STRUCTURE to delete the con- 
tents of a structure results in the structure being emptied, but structure mem- 
ory is not completely reclaimed. 

REDRAW ALL STRUCTURES 

Sometimes the screen is not redrawn after a REDRAW ALL STRUCTURES 
call. After an expose event, a REDRAW ALL STRUCTURES call is issued by 
the user's program. If the window has been moved before the expose event is 
generated, the window may not actually refresh. 

PWAIT 

The PWAIT definition conflicts with sys/param.h. PWAIT is also defined in 
<sys/param.h>. If this file is included after phlgs.h, an X error occurs when 
PWAIT is used in pset_dlsp_upd_st. To work around this, include 
phlgs.h after sys/param.h. 

INQUIRE ELEMENT CONTENT 

Inquiring the element content on an edge flag element does not return valid 
values. The returned element should be an enumerated type of PEDGE_ON 
or PEDGEJDFF. 

INQUIRE ELEMENT CONTENT gives bad data for the following PEX 
elements: 

. POLYLINE SET 3 WITH DATA 

. TRIANGLE STRIP 3 WITH DATA 

. QUADRILATERAL MESH 3 WITH DATA 

. FILL AREA 3 WITH DATA 

. FILL AREA SET 3 WITH DATA 

Primitives with No Data 

Because the graphics pipeline always assumes that there is at least the mini- 
mum amount of data needed to render a primitive, ppolymarker3 (or any 
primitive) with no data will cause the system to hang. When this happens, the 
system must be rebooted to restore the DSPs to a known state. You can try the 
following if you encounter this problem: 

♦ If you are in a network, rlogln and kill the stalled process, or 

• Use the key sequence CTRL-ALT-BREAK. 

To avoid this problem, make sure all primitives have data. 
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Picking After Moving a PEX Window 

The first time a structure is traversed after a PEX window is moved, the struc- 
ture is drawn in the window's new position. 

If you move a PEX window and don't immediately redraw the structure, 
the window stays black. If you then do a pick and hold down the button, the 
structure is displayed on its old location, and whatever item is picked is 
highlighted. A subsequent REDRAW ALL STRUCTURES call puts the 
model in its correct place in the window, and a subsequent pick at the exact 
same location returns the same screen coordinates, but picks the object 
currently under the pointer. 

EXECUTE STRUCTURE 

When structures are terminated with EXECUTE STRUCTURE elements, 
problems occur when that terminating EXECUTE STRUCTURE element is 
deleted. To avoid this possibility, you should terminate with something other 
than an EXECUTE STRUCTURE. 

pevalj^Sew__mapjTiatrix3 

Under certain conditions, pevaLviewjTiapjrtatrixS returns an incorrect 
mapping matrix. The conditions under which this occurs are as follows: 

• Hie identity is the orientation matrix. 

• Projection is oblique orthographic (with the PRP raised 5.0 vrc units 
in j off the VPN). 

• The view plane is not at vrc 0.0. 

If, for example, the vrc is -10.0, the matrix produced does not generate a 
view volume raised somewhat in y as one would expect; rather the view 
volume is still centered at vrc 0.0 and the image is rendered as such. If the 
projection type switched to PPERSPECTIVE, but all other parameters remain 
the same, suddenly the view volume is raised in y and the image is rendered 
as such. 

polymarkers 

ppoiymarkerS with no data (0 vertices) can cause the DSPs to hang because 
the graphics pipe assumes at least the minimum amount of data needed to ren- 
der a primitive. When this happens, the system must be rebooted to restore 
the DSPs to a known state. 

The primitives that can have no data are: polyline, polyline2d, marker, 
marker2d, polyline set. The gdps (sphere and cylinders) work with no data. 
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pset_ws_win3 

pset__ws_win3 doesn't work correctly. Setting clip limits in the view rep 
causes a change in the portion of NPC space you chose to display on the work- 
station. 

pset„ws_vp 

pset_ws_vp doesn't work correctly. This routine is influenced by any clip 
limits that are defined in pset_vlew_rep. It does not map the workstation 
window to the lower left hand corner of the window. 

pset_lnt_rep X Error 

When psetjnt_rep is called, the following is returned before the program 
exits: 

X Error of failed request: 128 
Major opcode of failed request: 12 9 (X3D-PEX) 
Minor opcode of failed request : 12 
(PEX_SetTableEntries) 
Value in failed request: 0x0 
Serial number of failed request: 447 
Current serial number in output stream: 448 

To avoid this problem, use individual elements instead of the bundle 
table. 

PHIGS Routine pset„elem_ptr_label 

When the label between the current pointer position and the end of the struc- 
ture does not exist, the PHIGS routine pset_elem_ptr Jabel should report an 
error to the screen or to a designated error file (depending on how popen_pex 
was set up). No error is reported. 

Pempty__struct 

The pempty__struct call does not remove references to previous 
structures. If you post a structure, then empty and reuse the structure, the 
system displays data from the previous reference. If the previous structure is 
deleted, the server generates the following error: 

X Error of failed request: Internal Graphics Error- 
- check error log in /tmp 

Lack of Swap Space Crashes Server 

Shuffling lots of images "leaks" memory and crashes the server. When this 
occurs, you appear to have no swap space when you should. Creating this 
problem often may crash the server with a segmentation fault. 
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X Window System Bugs Fixed 
XAIIowEvenfs 



XAIIowEvents doesn't allow events to be sent to the client that has grabbed 
the keyboard or the mouse. This bug is caused by a subtle interaction between 
the X input extension and the core X server. A bug report has been sent to the 
X consortium. 

xman Errors 

When you bring up the mwm manual page in xman, and scroll down to about 
the middle of page 5, the program exits and gives the following error: 

Error: SBLW: cannot be both bold and italic. 

XGetlmage Returns Incorrect Depth of Image 

Doing an XGetlmage using XYPixmap format (ZPixmap format does not 
suffer this bug) returns an Ximage structure with a depth field value of zero. 
Using this Ximage structure in a subsequent call to XPutlmage results in a 
BadMatch error because the image depth (0) doesn't match the drawable's 
depth (32). 

Assigning the Xlmage's depth field a value of 32 after it returns from XGet- 
lmage allows the image to be accessed successfully to XPutlmage; however, 
the image is not displayed correctly. 

Default Picking Behavior 

With no nameset specified, or inclusion or exclusion filters set, a pick travers- 
al tries to pick all primitives. With no names added to the nameset, nothing 
should be picked. If both the picking inclusion and exclusion filters are emp- 
ty, then no primitive is pickable. 



xterm 



In vl, if you type to the end of a line in an xterm, that line gets shifted to the 
right by about one character on the whole screen. 

XQueryColor 

XQueryColor does not return correct colors. If you load a set of 256 colors 
with XStoreColors, then query a color value with XQueryColor, you get in- 
correct values for red and green. If you store a single color, using 
XStoreColor, then read with XQueryColor, you get correct values. 

Picking Extension 

The Picking Extension returns the incorrect item number for cylinders in a 
single call. 
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bitmap Line Quality Irregularities 

Line drawing irregularities occur when using the X client bitmap. The line 
quality is variable. The initial line quality may be poor but may improve after 
a resize event. It will also improve after a refresh of the screen but only if sev- 
eral bits have been filled in first. The invert image is also irregular until after 
a refresh. 

The problem can be seen by starting the bitmap client with any filename. 

The change in quality is less noticeable when the -nodashed option is 
used when running bitmap. 

Oval Buttons Draw Incorrectly 

When an expose event is generated by a 3D window on a non-rectangular 
window (the oval buttons in xman, for instance), the borders of the windows 
are drawn incorrectly. This was verified as a property of editres (which also 
uses oval buttons), but not of xeyes. 

Graphics Manager Error File 

The error file used by the graphics manager (/tmp/X_gmerroriog) grows 
without bound when the structure walker encounters a segmentation fault. It 
seems to get stuck in a loop where it encounters the error, traps it, prints a 
message and continues execution only to encounter the error again. 

XChangePointerDevice 

If you change the core pointer to the tablet with XChangePointerDevice, 
mwm's pull-down menus don't respond correctly, i.e., the choice you are on 
often won't be highlighted. When you switch the core pointer back to the 
mouse, the problem still exists. Changing the focus window for the new 
pointer to Pointer Root Win may solve the problem. 
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OSF/Motif Bugs Fixed (^ 

R3/R4 Compatibility 

The Motif libraries and include files are in release 1.0. Since the Motif wid- 
gets depend upon an R3-compatible Toolkit Intrinsics library, developers cre- 
ating a Motif application must follow these rules: 

1) Always use the BSD environment. The options -systype bsd43 should 
always be specified when compiling any part of a Motif application. 

2) Link with the R3-compatible Toolkit Intrinsics. The file 
/bsd43/usr/llb/llbXtR3.a is the library that the application should be 
linked with. Use -IXtR3 instead of -IXt when linking. 

3) Use the Toolkit Intrinsics header files from /bsd43/usr/include/X1 1 R3. 
To make this a bit easier, there is a symbolic link named X1 1 in that di- 
rectory. You can, for example, use 

#include <Xll/Composite.h> 

in your source files if you add -l/bsd43/usr/include/X1 1 R3 to your com- 
pilation lines. This flag must precede any other include directory that may 
have a subdirectory named X1 1 . 



XmDrawingArea 

The XmDrawingArea widget ignores the XmNheight, XmNwidth resources 
when it is created. It is sizing itself based on the sizes of child widgets that are 
created under it, or defaulting to twice the child margins (XmNmarginWf dth, 
XmNmarginHeight) if no children are specified. To work around this bug, set 
the resources XmNmarginHeight and XmNmargfnWidth to be half of the 
desired height and width, respectively. 

XmText Widget Default Value 

The value of XmText widget does not default to an empty string. Do not de- 
pend on default values. 

XmNdirSpec Resource 

Attempts to change the setting of the XmNdirSpec resource of the 
XmFileSelectionBox widget fails. An attempt to set it to * results in a setting 
of Filter. 

XmNlistLabelString Resource 

Attempts to change the setting of the XmNlistLabelString resource of the 
XmSelectionBox widget are not performed correctly. It may be that setting 
other label string resources for the widget are interfering with the list label 
string. 
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XmNcursorPosition of XmText Widget 

There is a possibility of setting XmNcursorPosition of the XmText widget 
incorrectly when setting both the XmNcursorPosition and the 
XmNtopPosition resources. 

XmGetlmageFromFile 

The function XmGetlmageFromFile() does not work correctly. 

XmArrowButton Highlight 

A single XmArrowButton widget as the child of an AppiicationShell does 
not highlight correctly. 

XmPushButtonGadget Label 

The label for an XmPushButtonGadget as a child of an XmBuiletinBoard 
does not shift with the button as the button is moved around by the bulletin 
board. 

XmFileSeiection Widget 

An XmFileSeiection widget is almost completely inoperative. 

XmForm Widget 

An XmForm widget does not shrink when a child XmPushButton's top wid- 
get constraint is set to NULL. 

XmGetPixmap 

Attempts to retrieve nonexistent pixmaps using XmGetPixmap may corrupt 
the image cache. 

XmList 

The anchored XmList item does not unselect properly when SHIFT-CTRL 
dragged. 

XmNmargin* Not Inquirable 

XmNmarginWidth and XmNmarginHeight for an XmPushButtonGadget 
are reported incorrectly by XtGetValues(). 

XmScale Widget Label 

Rightmost labels for an XmScale widget are missing when 10 are drawn hor- 
izontally. A different number of them will be missing for each redraw at- 
tempt. 
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XmScrollBar Slider 

The XmScrollBar slider does not appear at the bottom of the scale with the 
following non-default settings: 

XmNvalue: 60 

XmNsllderSIze: 50 

XmNprocesslngDirectlon: XmMAX_ONJTOP 

XmScrollBar Click Movement 

A small horizontal XmScrollBar may appear to move the slider in the wrong 
direction in response to a click on one of the end arrows after the slider has 
been positioned by dragging. 

Callbacks from Mouse Click 

Callbacks are not called when clicking mouse button 1 in the scrollbar region 
with the CTRL or SHIFT keys pressed. 

XmText Widget 

The text in an XmText widget may disappear after some selection and inser- 
tion operations. 

XmPanedWindow 

An XmPanedWindow does not manage the geometry of three 
XmPushButton children correctly when interactively modifying the 
placement of the separators. 

mwm - Window Drag Blinking 

Sometimes the window outline during moves blinks very rapidly and may be 
mostly invisible. 

mwm - Window Icons Blank 

When many windows (more than 8) are iconified, some of the icons are blank. 
They do not display the pixmap that should be associated with the icon for 
that type of client. 

mwm - Illegal configFile Resource 

When a configFile resource is specified which does not exist, mwm has no 
menus at all. It should read the system configuration file to determine the de- 
fault behavior if the file specified by the configFile resource does not exist. 

mwm - Binding to ALT-F11 

Bindings for ALT-F1 1 do not work. 
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XmNmwmDeeorations 

A program cannot set its decorations for a Vendor Shell using 
XmNmwmDeeorations. OSF/Motif bug # 999 states that the 
MWM_HINTS property in a window does not get set up. However, the work 
around says that it can be set up after the shell is created using 
XtSetValues. 

On the ES V Workstation, the MWM_HINTS property does get created and 
the values for the decorations get set, but the window does not reflect the 
correct values set for decorations. The code below reflects the OSF/Motif 
work around: 

XtToolkitlnitializeO ; 

d = XtOpenDisplay (NULL, NULL, argv[0], "go", NULL, 0, &argc, argv) ; 

n=0; 

wid 

=XtAppCreateShell ("go", "go", topLevelShellWidgetClass,d, args,n) ; 

n=0; 

XtSetArg (args [n],XinNheight, 500) ; n++; 

XtSetArg(args[n],XmNwidth,500) ; n++; 

XtSetArg (args [n] , XmNmwmDeeorations, MWM_DECOR_BORDER) ; n++; 

XtSetValues (wid, args, n) ; 

n=0; 

XtSetArg (args [n] , XmNheight, 500) ; n++; 

XtSetArg (args [n] , XmNwidth, 500) ; n++; 

txt = XmCreateText (wid, "txt", args, n) ; 

XtManageChild(txt) ; 

XtRealizeWidget (wid) ; 
XtMainLoop () ; 

The decorations can be set up in the .Xdefaults file. 
stty Commands Hang mwm 

When stty calls are made from a .cshrc, when mwm opens an xterm the 
mwm process is hung. The mwm process must be killed and restarted to get 
back control of the display, mwm version 1.1.1 fixes this. 

Rowcolumn Widget Causes Bus Error When Destroyed 

When a widget tree containing a Motif Rowcolumn widget is destroyed using 
XtDestroy Widget a bus error is generated. If a different widget (such as form 
or bulletin board) is substituted no bus error occurs. 
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4. Documentation Corrections 

The following corrections and additions should be made in the appropriate 
documents. 

ESV Workstation Reference Manual [2.0], "1. ESIPEX" 

The syntax for the FORTRAN OPEN PHIGS, OPEN XPHIGS, and 

OPEN WORKSTATION calls should be added to this chapter. 

OPEN PHIGS FORTRAN Call 

Syntax 

POPPH(E/?HF/L, BUFA) 
INTEGER ERRFIL 
INTEGER BUFA 

FORTRAN Input Parameters 

ERRFIL Error file number 

BUFA Amount of memory units (ignored) 

OPEN XPHIGS FORTRAN Call 

Syntax 

POPXP(ERRFIL, BUFA, MASK, INFO) 
INTEGER ERRFIL 
INTEGER BUFA 
INTEGER MASK 
INTEGER INFO(2) 

FORTRAN Input Parameters 

ERRFIL Error file number. 

BUFA Amount of memory units (ignored). 

MASK Bitmask to indicate which parts of INFO are valid. MASK can 

have either of the values PXPIDI and PXPINM or the sum of the 
values. 

PXPIDI indicates that the Display * is present in INFO(1). 

PXPINM indicates that the no_monitor flag is present in 
INFO(2), 

INFO(2) Information about the type of OPEN that is to be done. 
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OPEN WORKSTATION FORTRAN Call 

Syntax 

POPWK(WS/D, CONID, WTYPE) 
INTEGER WSID 
INTEGER CONID 
INTEGER WTYPE 

FORTRAN Input Parameters 

WSID Workstation ID. 

CONID Connection identifier. If WTYPE is phigswstypextool, then 

CONID can be either a or 1 . If CONID is 0, the default serv- 
er is used for the connection. If CONID is 1, the common vari- 
able dispname is used as the connection ID in the call to 
popen_ws. 

WTYPE Workstation type. WTYPE can be phigswstypexdrawable 

or phigswstypextool. 

If WTYPEis phigswstypexdrawable, the common variables 
phigsdisplay and phigswindow will be used in the 
Pconnid_x_drawable structure in a call to popen_ws. 
CONID is ignored in this case. 

If WTYPEis phigswstypextool, CONID is examined. 
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phigs77.h 

The following common areas and variables are defined at the end of the 
phigs77.h file: 

C The default workstation types. 

COMMON /phigs77wstypes/ phigswstypexdrawable, phigswstypextool 
INTEGER phigswstypexdrawable 

INTEGER phigswstypextool 

C The connection id for drawable workstations 

COMMON /phigs77connid/ phigsdisplay, phigswindow 
INTEGER phigsdisplay 

INTEGER phigswindow 

C The display name for tool workstations 
COMMON /phigs77dispname/ dispname 
CHARACTER* 80 dispname 

C The info mask values. 

PARAMETER (PXPIDI=1, PXPINM=16) 



2.0 Release Notes 4 - 3 



Documentation Corrections 



SunPHIGS Document Set f 

Known Size Limitations on Structure Elements 

Since structure elements are communicated to the central structure store via 
the connection to the X server(s), structure elements are limited in size by the 
request buffer size of the server. The request buffer size can be found using 
the xdpyinfo(1) command. Currently, the buffer size is 64 K long words, or 
256 Kbytes. 

For polygon (FILL AREA, FILL AREA SET, etc.) structure elements, 
there is a further restriction of no more than 128 vertices (64 if the primitive 
includes colors or normals, 42 if the element includes colors and normals for 
each vertex) per element. This limitation is imposed by the size of the 
processing buffer in the DSPs. 
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5. Installation Instructions 



This chapter contains information on ES V Workstation tape drives and pro- 
vides installation instructions for release tapes. This chapter is organized as 
follows: 

Page 

Installation Notes 5-2 

Tape Drive Data Cartridge Information 5-6 

2.0 Release Subpackage Sizes 5-7 

rmpgkTool 5-11 

ES/os Domestic/Foreign Tape- Update 5-12 

ES/os Domestic/Foreign Tape- Scratch 5-23 

ES/PEX Server Tape 5-35 

ES/PEX Library Tape 5-40 

ES/PSX Tape 5-43 

ES/DnetTape 5-46 

AVS Tape 5-49 

ES/Diskless Node Tape 5-52 

ES/Kodak Printer Tape 5-66 



Caution: You should carefully read the "Installation 
Notes" section before you begin the software 
installation 
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Installation Notes 



The 2.0 release supports multiple software configurations. ES V machines 
come from the factory with software installed in the basic configuration. Ad- 
ditional software may be installed by the ES V's system manager. 

As new software is released, each ES V system manager must decide the 
particular configuration desired, and install the appropriate updates. The 
choices involve: 

• Which optional tapes should be installed. This is usually determined 
by what was purchased with the ES V. For example, some of the op- 
tions are the Developer's Kit Option, the FORTRAN compiler, 
ES/Dnet, PSX, etc. 

• Which OS kernel to install. This generally depends on whether or not 
the Developer's Kit is to be installed on the system. See "OS Kernel 
Information" below. 

• Which subpackages of the OS, Server and Development Kit tapes to 
install. This generally depends on whether or not the Development Kit 
is to be installed. See the "Configuration Information" below. 



OS Kernel Information 



There are two kernels available on the tape. The "non-development" kernel 
provides smaller resource allocations and can be used when systems mainly 
run existing applications. Beginning with the 2.0 release, this kernel is in- 
stalled on the ES V when it is shipped from the factory. For systems in which 
large application compiles and builds are done, the "development" kernel, 
which provides larger resource allocations, should be used. 

To determine which type of kernel has previously been loaded on the 
system, you can boot the system and type the following command: 

uname -A 

This command will print the following system information: 

sysname, nodename, release, version, machine, rnjype, and base_rel. 

The m_type will be one of the following: 

• ml 20- 1 if the non-development kernel was installed 

• ml 20-2 if the development kernel was installed 

Note that all releases prior to 2.0 had only the development kernel. 

If you need to install a kernel other than the one on the system, you can 
do so by following the Operating System Update Installation Instructions, but 
only installing the root and m-120x subpackages. 
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Configuration Information 

The OS tape, the Server tape, and the Library tape (Developer's kit tape) in- 
clude various optional subpackages. Since each subpackage requires space on 
the ES V disk, only those which will be used should be installed. The "2.0 Re- 
lease Subpackage Sizes" section in this chapter provides information about 
disk space utilization of the various subpackages and options. 

Beginning with the 2.0 Software Release, the following are the 
subpackages installed on the ES V before it is shipped from the factory. See 
the definitions for non-development and development systems below before 
deciding which subpackages to choose. 

The following contains recommendations for which subpackages to 
install: 

Non-Development Systems 

All non-development systems (Standard Media Kit with/without PSX, 
ES/Dnet, LAT Host Services Options) should only install the following tape 
subpackages: 

ES/os Tape (Domestic or Foreign) 

root - installed automatically on SCRATCH install 
ml20-x - installed automatically on SCRATCH install 
usr - installed automatically on SCRATCH install 

cmplrs - you must type 'y' when prompted 
man - you must type 'y' when prompted 
bsd43 - you must type 'y' when prompted 

ES/PEX Server Tape 

executables_s - you must type V when prompted 
library_s - you must type 'y' when prompted 

pexs_man - you must type V when prompted 

fstest - you must type 'y' when prompted 

PSX. ES/Dnet and LAT Host Services Options 

All Subpackages 

Development Systems 

All development systems (Development Kit with/without Ada, AVS, Pascal, 
Fortran, PSX, ES/Dnet, LAT Host Services Options) should install the tape 
subpackages as follows: 
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ES/os (Domestic or Foreign) I 

All Subpackages 
ES/PEX Server 

All Subpackages 
ES/PEX Library (Development Kit) 

libraryj 

pexl-man 

pexl-man-unformat 
All other Options 

All Subpackages 

LS Systems 

All LS systems should install the tape subpackages as follows: 

ES/os (Domestic or Foreign) 

Up to your system manager. You may install the non-development or 
development configuration for CPUS and CPUG. 

ES/PEX Server f 

The CPUS only needs the following subpackages: V 

executables_s 

library_s 

pexs-man 

The CPUG should at least have the non-development configuration 
mentioned above. You may install more subpackages. 

ES/PEX Library (Development Kit) 

Both CPU's should have at least the following: 

libraryj 

pexl-man 

All other Options 

Graphics Options should be installed on the CPUG (Graphics CPU, 
i.e., PSX, AVS etc). Other options can go on either CPU depending on 
how much disk space you have available. 



( 
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CDRS Systems 

All CDRS Systems should install the tape subpackages as follows: 
ES/os (Domestic or Foreign) 

All Subpackages 
ES/PEX Server 

All Subpackages 
ES/PEX Library (Development Kit) 

All Subpackages 
All other Options 

All Subpackages 

xman Setup Script 

To set up directories for the xman client, follow these steps: 

1) Login as root 

2) cd /usr/man 

3) su bin 

4) . /make . xman . sections 

5) Answer prompts appropriately, xman will work when invoked after run- 
ning this script. 

6) Type exit to return to root prompt. 

Remove Package/Subpackage Utility 

With Release 2.0, a new feature is provided to remove packages or subpack- 
ages to free up needed disk space. It is called rmpkg. Instructions on how to 
use this tool are located on page 5-11. 
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Tape Drive Data Cartridge Information 

The Evans & Sutherland ESV Graphics Workstation currently uses the 
TANDBERG DATA (SIEMENS) 3660 Series Tape Drive. 

Data Cartridges that have proven to work on this drive: 



Vendor 


Product 


Tape 
Length 


Mbyte 
Capacity 


Notes 


3M 
3M 
BASF 


DC600A 
DC615A 
DC600H 


620 ft. 
150 ft. 
620 ft. 


120 meg 
30 meg 
120 meg 


Used prior to 2.0** 
Used prior to 2.0** 
Used prior to 2.0** 


3M 

3M 


DC6037 
DC6150 


150 ft. 
600 ft. 


37 meg 
150 meg 


Used for Software 
Distribution 
Used for Software 
Distribution 



c 



** We have found that these tapes cause pre-mature head wear and are not 
recommended on the ESV anymore. They may be used if the new tapes are 
not available. 
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2.0 Release Subpackage Sizes 

These sizes are provided to help you configure your system based on how 
much disk space you have available. The Kbyte value is the one you need to 
determine what will fit on your disk. Type df/usr to see how many Kbytes 
you have available and use chart below to determine any additional sub-pack- 
ages you wish to install, (see "Configuration Information" for listing of sub- 
packages installed at the factory). 



Domestic 








Subpackage 


Bvtes 


Kbvtes 


Meg 


root* 


10975284 


10718 


10.47 


m 120-1* 


5372173 


5246 


5.12 


m 120-2 


5372215 


5246 


5.12 


usr* 


37562740 


36682 


35.82 


usr_help 


774766 


757 


0.74 


usr_dvlp 


11370262 


11104 


10.84 


usrjerms 


1823098 


1780 


1.74 


cmplrs* 


11015953 


10758 


10.51 


cmplrs-bsd43 


1665432 


1626 


1.59 


man* 


4103341 


4007 


3.91 


manjnisc 


81082 


79 


0.08 


bsd43* 


12315535 


12027 


11.75 


bsd43_troff 


96862 


95 


0.09 


bsd43_dvlp 


4656482 


4547 


4.44 


reconfig 


12125063 


11841 


11.56 


emacs 


10143932 


9906 


9.67 


posix 


3269801 


3193 


3.12 


uucp 


2718805 


2655 


2.59 


sees 


195155 


191 


0.19 


news_readers 


864159 


844 


0.82 


games 


3779744 


3691 


3.60 


mh 


17461336 


17052 


16.65 


Non-Dvlp Config* 


81345024 


79439 


77.58 


Dvlp Config 


13446340C 


1 131312 


128.23 



1— Install one only 



* Installed at Factory for Non-Dvlp Systems 
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ES/os Foreign 








Subpacka^e 


Bytes 


Kbytes 


Meg 


root* 


10903709 


10648 


10.40 


m 120-1* 


5372173 


5246 


5.12 


m 120-2 


5372215 


5246 


5.12 


usr* 


37508060 


36629 


35.77 


usrjhelp 


774766 


757 


0.74 


usr_dvlp 


11370262 


11104 


10.84 


usrjerms 


1823098 


1780 


1.74 


empire* 


11015953 


10758 


10.51 


cmplrs-bsd43 


1665432 


1626 


1.59 


man* 


4103341 


4007 


3.91 


manjmisc 


81082 


79 


0.08 


bsd43* 


12315535 


12027 


11.75 


bsd43„troff 


96862 


95 


0.09 


bsd43_dvlp 


4648734 


4540 


4.43 


reconfig 


12125063 


11841 


11.56 


emacs 


10143932 


9906 


9.67 


posix 


3269801 


3193 


3.12 


uucp 


2718805 


2655 


2.59 


sees 


195155 


191 


0.19 


news_readers 


864159 


844 


0.82 


games 


3779744 


3691 


3.60 


mh 


17461336 


17052 


16.65 


Non-Dvlp Config 


81218776 


79315 


77.46 


Dvlp Config 


134337100 


131189 


128.11 



* Installed at Factory for Non-Dvlp Systems 
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ES/PEX Server 2.0 








Subpackage 


Bvtes 


Kbvtes 


Meg 


executables_s* 


12308787 


12020 


11.74 


library_s* 


9160771 


8946 


8.74 


pexs-man* 


1238284 


1209 


1.18 


fstest* 


9920400 


9688 


9.46 


xclients_s 


17937647 


17517 


17.11 


pexs-man-unformat 


1055019 


1030 


1.01 


demo s 


6952381 


6789 


6.63 


Non-Dvlp Config* 


32628242 


31864 


31.12 


Dvlp Config 


58573289 


57200 


55.86 


* Installed at Factory for Non-Dvlp Systems 




ES/PEX Library 2.0 








Subpackage 


Bvtes 


Kbvtes 


Meg 


libraryj 


23927799 


23367 


22.82 


cdrs_library 


19876032 


19410 


18.96 


pexl-man 


4924721 


4809 


4.70 


pexl -m an-unformat 


6397531 


6248 


6.10 


Non-CDRS Config 


35250051 


34424 


33.62 


CDRS Config 


55126083 


53834 


52.57 


ES/PSX 2.0 








Subpackage 


Bvtes 


Kbvtes 


Meg 


psx 


6560772 


6407 


6.26 


MIPS Pascal 2.11 








Subpackage 


Bvtes 


Kbvtes 


Meg 


pascal 


596420 


582 


0.57 


pascal-bsd43 


111917 


109 


0.11 


pascal-man 


31796 


31 


0.03 


Total 


740133 


723 


0.71 


MIPS Fortran 2.11b 








Subpackage 


Bvtes 


Kbvtes 


Meg 


177 


2184804 


2134 


2.08 


f77-bsd43 


1716043 


1676 


1.64 


f77-man 


64327 


63 


0.06 


Total 


3965174 


3872 


3.78 
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MIPS Ada 3.0 








Subpackage 


Bvtes 


Kbvtes 


Meg 


ada 


16822633 


16428 


16.04 


ada-man 


92908 


91 


0.09 


Total 


16922633 


16519 


16.13 


MIPS C 2.11.4ada (Goes with Ada Compiler 


) 




Suboackaee 


Bvtes 


Kbvtes 


Meg 


cmplrs 


10017899 


9783 


9.55 


ES/AVS 2.0 








Subpackage 


Bvtes 


Kbvtes 


Meg 


avs 


22786337 


22252 


21.73 


ES/Dnet 








Subpackage 


Bvtes 


Kbvtes 


Meg 


esdnet 


8744413 


8539 


8.34 


ES/LAT Host Services 








Subpackage 


Bvtes 


Kbvtes 


Meg 


eslat 


434818 


425 


0.41 


ES/Diskless Node 








Subpackage 


Bvtes 


Kbvtes 


Me^ 


droot 


2654198 


2592 


2.53 


dusr 


37711 


37 


0.04 


dvar 


512 





0.00 


Total 


2692421 


2629 


2.56 


ES/Kodak Printer 








Subpackage 


Bvtes 


Kbvtes 


Meg 


kodak 


489406 


477 


0.47 
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rmpgk Tool 

This tool is provided to remove installed packages/subpackages from your ESV. This allows 
you to free up needed disk space should you choose to do so. 

Login as root. 

cd /usr/pkg/bin 

Type . /zmpkg <package> (possible packages to remove are found in /usr/pkg/lib) 

You will be prompted for each subpackage to remove from the given package. 

Note: This program prompts all subpackages available 
from a package even though it may/may not be 
installed. If you type V to a subpackage that is not 
installed, nothing happens. 

Example: Removing man pages from ES/PEX Server release 

„ /rmpkg pexs2 . 

Pkgroot=/, Pkg=/usr/pkg/lib/pexs2 . (package pexs 2.0) 

Remove pexs .executables_s 2.0 (y n) [n]? n 

Remove pexs . library_s 2.0 (y n) [n] ? n 

Remove pexs .pexs-man 2.0 (y n) [n] ? y 

Remove pexs . f stest 2.0 (y n) [n]? n 

Remove pexs .xclients_s 2.0 (y n) [n]? n 

Remove pexs .pexs-man-unf ormat 2.0 (y n) [n] ? n 

Remove pexs.demo_s 2.0 (y n) [n] ? n 

The following subpackages have been selected for removal: pexs-man 
Ok (y n) [y]? y 

removing pexs .pexs-man 2.0... 

rm . /usr/man/catman/P_man/man7 /colour. 7 

rm . /usr/man/catman/P_man/man7/phigs_description_table . 7 

rm ./usr/man/catman/P_man/man7/phigs_workstation_description_table.7 



rm . /usr/man/x_man/manl/xwud. 1 

rm . /usr/man/x_man/man5/gm_conf ig.5 

rm . /usr/man/x_man/man5/pex_conf ig. 5 

Some of the boms for subpackages in this package remain in the packaging 

information tree, so the packaging information tree will not be removed. 

# 
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ES/os Domestic/Foreign Tape 2.0 - Update Installation 
Things to Check PRIOR to an Update Installation 

Before beginning this installation, you should verify that your system has enough disk space 
available. For successful installation of all packages on this tape there must be at least 4000 
additional Kbytes available on /dev/usr. Use the df command to get a listing of the bytes 
available on your machine. 

If your machine does not have enough space on /dev/usr, you may be able to reclaim a large 
amount of space by removing unneeded system-crash core files. This can be done as follows: 

cd /usr/adm/crash 
Is -1 

If the listing shows any files named core.# or unlx.#, remove them. 

rm . /core . * 

rm . /unix . * 

If you still do not have enough room, you will need to do further file cleanup, i.e., transfer 
some of your users accounts to another disk and/or elect not to install all the subpackages. 

Furthermore, when this script asks you if you want to clean up old versions of subpackages, 
always type y, to free up needed disk space. 

Installation Begins Here 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed 
as shown and entered with a carriage return. 

To install this tape, insert the ES/os Domestic or Foreign Tape into the tapedrive, and pro- 
ceed as follows: 

1) Power up the machine and let it run its power-on diagnostics. Make sure they all PASS. 
OR... 

1) Login as root. 

2) Clean up filesystems by typing f sck . f f s. 

3) Maker sure everyone else is off the machine (includes rlogins). 

4) Remove mouse from mousepad. 

5) Pay attention to the case-sensitivity of entries. 

6) Type sync; sync 

7) Type telinit 

E&S CPU Board MIPS Monitor Version 4.10 MIPS OPT Mon Feb 18 15:00:28 MST 
1991 
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Copyright 1988, MIPS Computer Systems Inc . , All Rights Reserved 
Memory size: 33554432 (0x2000000) bytes 
Icache size: 65536 (0x10000) bytes 
Dcache size: 65536 (0x10000) bytes 

» boot -f tqis (, , 2) sash.std 

120544+23088+170432 entry: 0xa0300000 

MIPS Standalone Shell Version 5.00 MIPS OPT Mon Feb 18 08:39:23 MDT 1991 

sash: cp -b 16k tqis (,,4) dkis(,,l) 

Note: @5 minutes till next user response 



13824000 (Oxd2fOOO) bytes copied 

Note: The next input determines the OS kernel you will 
be installing. There are two to choose from. See 
"OS Kernel Information" located at the beginning 
of these installation notes before typing the next 
command. 

sash: boot -f tqis (, , 6)unix.std root=isc0d0sl (non-development systems) 

OR 

sash: boot -f tqis (, , 7 ) unix . dvlp_std root=isc0d0sl (development systems) 

846208+101360+789520 entry: 0x80021000 

CPU: MIPS R3000 Processor Chip Revision: 2.0 

FPU: MIPS R3010 VLSI Floating Point Chip Revision: 2.0 

ES/os Release 2.0 ESV Version R_100 

Total real memory = 33554432 

Available memory = 31170560 

abminit: ARS/HIC not present. 

arsinit: ARS/HIC not present. 

installing VME vector: addr 0x8007FFA4 ipl 2, vec OxEO unit 

Root on dev 0xl001 f Swap on dev 0x1001 
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installing VME vector: addr 0x8007FFA4 ipl 2, vec OxEO unit 

Root fstype ffs 

New swplo: 26992 swap size: 19272K bytes 

Available memory = 29478912 

Miniroot run level 1 

Making miniroot device files for ml20-l system. . . 
erase = A H, kill = A U, interrupt = A C 

# set -a 

# Install=update 

# inst 

Software package installation 

This is an update install. 

Packages will be read in from the local Q24 tape drive. 

Machine type: ml20-l 

Is the information above correct? (y n) [y] ? <CR> 

Note: It is not necessary to install a kernel on the miniroot. The process 

will take a few minutes . 

Would you like to install the kernel to the miniroot (y n) [n] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 

root — - ES/os Standard Root Filesystem 

ml20-l — ES/os m/120, RC3240 Kernel and Devices 

usr — ES/os Standard /usr Filesystem 

usr__help — ES/os Standard /usr help facilities 

usr_dvlp — ES/os Standard /usr Development files (header files & 

libraries) 

usr_terms — ES/os Standard /usr Miscellaneous Terminal descriptions 

cmplrs -- MIPS-C Compiler 

cmplrs-bsd43 — MIPS-C 4.3 BSD Include Files and Libraries 

man — ES/os Manual Pages 

bsd43 — ES/os 4.3 BSD Utilities, Include Files and Libraries 

bsd43_troff — ES/os 4.3 BSD Troff Utilities and Libraries 

bsd43__dvlp -- ES/os 4.3 BSD Include Files and Libraries 

reconfig ~ Kernel Binary Reconfiguration Components 

emacs — emacs 

posix — ES/os POSIX P1003.1 Include Files, Commands and Libraries 

uucp ■ — UUCP 

sees — SCCS 

news readers — News Readers 



C 



( 



( 
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games — Games 
mh — mh 

========== selecting subpackages ========== 

Note : This OS release contains more subpackages than the 1.3 

release. Some existing 1.3 subpackages were broken out into 
smaller subpackages to allow you tailor the install to your 
needs and requirements. If you are unsure if you need a 
particular subpackage or not, type 'n' at the next prompt and 
follow instructions to list the contents of a subpackage. If 
you installed ALL the subpackages of the 1.3 OS release, 
you may want ALL of the subpackages on this tape. 

You may select all of the above subpackages by answering y to the following 
question. If you answer n, you will be asked to select the optional 
subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 



The current value of the clock is: Thu Aug 30 16:32:55 PDT 1990 
Is the clock correct (y n) [y] ? <CR> 



========== verifying single-user mode ========== 

The system is in a single-user run level. 

Please answer y to the following question unless you really understand the 
consequences . 

Do you want to install sash to the volume header (y n) [y] ? <CR> 

========== installing sash to volume header ========== 

========== mounting filesystems ========== 

Note: If your get a "dirty filesystem" error here, type the following: 

# fsck.ffs Kfilesystem path> (i.e. /dev/dsk/iscOdOsl) 

Otherwise, this should appear: 

/dev/root mounted on /mnt 
/dev/usr mounted on /mnt/usr 

Partition Megs Mounted File System or Partition Usage 

/dev/dsk/iscOdOsO 23 /dev/root 
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1 /dev/dsk/iscOdOsl 33 / 

6 /dev/dsk/isc0d0s6 564 /dev/usr 

7 /dev/dsk/isc0d0s7 14 -**** Available Partition ****- 



C 



Disk Device /dev/dsk/isc0d0s2 632 Megabytes Total Size 

Do you wish to change swap partition configuration (y n) [n] ? n 



preserving local files 



Running preserve 
No preserve list 
Running preserve 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 
No preserve list 



-s for subpackage root . . . 55 files preserved. 

or findmods list for ml20- preserve not executed. 

-s for subpackage usr... 25 files preserved. 

or findmods list for usr_help- preserve not executed. 

or findmods list for usr__dvlp~- preserve not executed. 

or findmods list for usr_terms- preserve not executed. 

or findmods list for cmplrs- preserve not executed. 

or findmods list for cmplrs-bsd43- preserve not executed. 

or findmods list for man- preserve not executed. 

or findmods list for bsd43~ preserve not executed. 

or findmods list for bsd43_trof f- preserve not executed. 

or findmods list for bsd43_dvlp- preserve not executed. 

or findmods list for reconfig- preserve not executed. 

or findmods list for emacs- preserve not executed. 

or findmods list for posix- preserve not executed. 

or findmods list for uucp- preserve not executed. 

or findmods list for sees- preserve not executed. 

or findmods list for news_readers- preserve not executed. 

or findmods list for games- preserve not executed. 

or findmods list for mh- preserve not executed. 



========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? <CR> 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming... 

You will see either this: 



( 



device 


fofree 


if ree 


breq 


ireq 


bcred 


icred 


/dev/root 


7873 


8858 


15146 


440 


9221 


320 


/dev/usr 


61418 


109649 


108483 


7264 


50649 


5788 



c 
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WARNING! This package will fit on the disk, but it will 
cause more than 90% of the disk to be used. This may cause 
problems for non-root users. It is recommended that you 
abort the installation now. 



OR this: 



The package (and any selected optional subpackages) cannot be installed at 
this time due to the shortage (s) of disk space and/or inodes shown above. 
Please make the required space available and then retry the installation 
procedure . 

(Press return to continue...) 

The script now restores the -preserve files and returns to the following 
prompt : 

# <-At this prompt, SEE SYSTEM MANAGER. 

OR this : 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage root... 
Stripping links for subpackage ml20-l... 
Stripping links for subpackage usr... 
Stripping links for subpackage usrjielp. . . 
Stripping links for subpackage usr_dvlp. . . 
Stripping links for subpackage usr_terms... 
Stripping links for subpackage cmplrs... 
Stripping links for subpackage cmplrs-bsd43 . . . 
Stripping links for subpackage man... 
Stripping links for subpackage bsd43... 
Stripping links for subpackage bsd43_trof f . . . 
Stripping links for subpackage bsd43_dvlp. . . 
Stripping links for subpackage reconfig. . . 
Stripping links for subpackage emacs . . . 
Stripping links for subpackage posix. . . 
Stripping links for subpackage uucp. . . 
Stripping links for subpackage sees... 
Stripping links for subpackage newsreaders... 
Stripping links for subpackage games... 
Stripping links for subpackage mh... 

========== extracting files from subpackage archives ========== 



rewinding the tape . . . 
Verifying tape id. . . ok 
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Forward spacing the tape... 

Loading subpackage : root . . . 
Forward spacing the tape . . . 
Loading subpackage: ml20-l... 
Forward spacing the tape... 
Loading subpackage: usr... 
Forward spacing the tape . . . 
Loading subpackage: usr_help. . . 
Forward spacing the tape... 
Loading subpackage: usr__dvlp. . . 
Forward spacing the tape... 
Loading subpackage: usr_terms... 
Forward spacing the tape... 
Loading subpackage: cmplrs... 
Forward spacing the tape... 
Loading subpackage: cmplrs-bsd43 . 
Forward spacing the tape... 
Loading subpackage: man... 
Forward spacing the tape... 
Loading subpackage: bsd43... 
Forward spacing the tape... 
Loading subpackage: bsd43_trof f . . 
Forward spacing the tape... 
Loading subpackage: bsd43_dvlp. . . 
Forward spacing the tape... 
Loading subpackage: reconfig. . . 
Forward spacing the tape... 
Loading subpackage : emacs . . . 
Forward spacing the tape... 
Loading subpackage: posix. . . 
Forward spacing the tape... 
Loading subpackage: uucp. . . 
Forward spacing the tape . . . 
Loading subpackage: sees... 
Forward spacing the tape... 
Loading subpackage: news_readers . 
Forward spacing the tape... 
Loading subpackage : games . . . 
Forward spacing the tape... 
Loading subpackage : mh . . . 
Forward spacing the tape... 
rewinding the tape... 



C 



C 



making device special files 



C 
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running MKDEV. . . 
done. 

running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass . 



doing uncompress Thu Apr 04 17:17:24 PST 1991 



uncompress usr/bin/admin. Z 
uncompress usr/bin/at.Z 
uncompress usr/bin/chkey .Z 

(Un-compresses occur here...) 

uncompress usr/new/mh/vmh.Z 
uncompress usr/new/mh/whatnow.Z 
uncompress usr/new/mh/whom. Z 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

At this point, you may be asked to "Cleanup" old software from the system. 

It is recommended that you type *y' to these inquiries . 

========== restoring preserved user files ========== 

Running preserve -r for subpackage root... 

No preserve list or findmods list for ml20-l- no files restored. 

Running preserve -r for subpackage usr. . . 

No preserve list or findmods list for usr_help- no files restored. 

No preserve list or findmods list for usr_dvlp- no files restored. 

No preserve list or findmods list for usr__terms- no files restored. 

No preserve list or findmods list for cmplrs- no files restored. 

No preserve list or findmods list for cmplrs-bsd43- no files restored. 

No preserve list or findmods list for man- no files restored. 

No preserve list or findmods list for bsd43- no files restored. 

No preserve list or findmods list for bsd43__trof f- no files restored. 

No preserve list or findmods list for bsd43_dvlp- no files restored. 

No preserve list or findmods list for reconfig- no files restored. 

No preserve list or findmods list for emacs- no files restored. 

No preserve list or findmods list for posix- no files restored. 

No preserve list or findmods list for uucp- no files restored. 
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No preserve list or findmods list for sees- no files restored. 1 

No preserve list or findmods list for newsreaders- no files restored. 
No preserve list or findmods list for games- no files restored. 
No preserve list or findmods list for mh- no files restored. 



running conversion scripts ========== 

root. f stab Thu Apr 04 17:24:49 PST 1991 



No ips devices found in /etc/fstab. 

To take advantage of the improved parallel fsck, /etc/fstab will now be 
modified to allow the root partition to be fsck'd on the first pass. All 
other local filesystems will be fsck'd on the second pass. 

A copy of /etc/fstab will be saved as /etc/f stab. save. 1 . 
No changes made. 

Press return to continue: <CR> 

========== cleaning up ========== 



Copying packaging information directory to /mnt/usr/pkg/lib/ESosl .3 . 

Removing Duplicate File /mnt/etc/TZ : 1 .3+ 
Removing Duplicate File /mnt/etc/exports : 1 .3+ 
Removing Duplicate File /mnt/etc/f stab: 1 .3+ 
Removing Duplicate File /mnt /etc/group: 1 . 3+ 
Removing Duplicate File /mnt/etc/inittab: 1 .3+ 
Removing Duplicate File /mnt/etc/motd:l .3+ 
Removing Duplicate File /mnt/etc/networks : 1 .3+ 
Removing Duplicate File /mnt/etc/passwd: 1 .3+ 
Removing Duplicate File /mnt/usr/etc/exports : 1 .3+ 
Removing Duplicate File /mnt/usr/etc/bootptab: 1 .3+ 
Removing Duplicate File /mnt/usr/etc/timed.conf : 1 . 3+ 
Removing Duplicate File /mnt/usr/lib/aliases : 1 .3+ 
Removing Duplicate File /mnt/usr/lib/sendmail.cf : 1 .3+ 
Removing Duplicate File /mnt/usr/lib/me/local.me : 1 .3+ 

Unmounting filesystems... 
/mnt /us r: Unmounted 
/mnt : Unmounted 



C 



installation complete 



# sync; sync 

# telinit 

# 

INIT: New run level: 



C 
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Miniroot shutdown 

E&S CPU Board MIPS Monitor Version 5.00 MIPS OPT Mon Feb 18 15:00:28 MST 

1991 

Copyright 1988, MIPS Computer Systems Inc., All Rights Reserved 

Memory size: 33554432 (0x2000000) bytes 

Icache size: 65536 (0x10000) bytes 

Dcache size: 65536 (0x10000) bytes 

>> auto 

Autoboot: Waiting to load dkis (0, 0, 8) sash (CTRL-C to abort, RETURN 
to expedite) <CR> 

loading 

120544+23088+170432 entry: 0xa0300000 

MIPS Standalone Shell Version 5.00 MIPS OPT Mon Feb 18 08:39:23 MDT 1991 

Loading dkis (0,0,0) /unix 

846208+101360+789520 entry: 0x80021000 

CPU: MIPS R3000 Processor Chip Revision: 2.0 

FPU: MIPS R3010 VLSI Floating Point Chip Revision: 2.0 

ES/os Release 1.3.10 ESV Version R_100 

Total real memory = 33554432 

Available memory = 31170560 

abminit: ARS/HIC not present. 

arsinit: ARS/HIC not present. 

installing VME vector: addr 0x8007FFA4 ipl 2, vec 0xE0 unit 

installing VME vector: addr 0x8007FFA4 ipl 2, vec 0xE0 unit 

Root fstype ffs 

Available memory = 29478912 

Checking root file system () if necessary. 
The system is coming up. Please wait. 

***** Normally all file systems are fscked. 

***** to fsck only dirty ones, type ^yes' within 5 seconds: 

***** ah file systems will be fscked. 

/dev/usr: 6199 files, 109289 used, 431746 free (2882 frags, 53608 blocks, 

0.5% fragmentation) 

/dev/usr mounted on /usr 

No process accounting on this system 

Aug 31 07:19:19 tonto unix: CPU: MIPS R3000 Processor Chip Revision: 2.0 

Aug 31 07:19:19 tonto unix: FPU: MIPS R3010 VLSI Floating Point Chip 

Revision: 2.0 

Aug 31 07:19:20 tonto unix: 

Aug 31 07:19:20 tonto unix: Total real memory = 33554432 
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Aug 31 07:19:20 tonto unix: Available memory = 31170560 f 

Aug 31 07:19:20 tonto unix: abminit : ARS/HIC not present. 

Aug 31 07:19:20 tonto unix: arsinit: ARS/HIC not present. 

Aug 31 07:19:21 tonto unix: installing VME vector: addr 0x8007FFA4 ipl 2, 

vec OxEO unit 

Aug 31 07:19:21 tonto unix: installing VME vector: addr 0x8007FFA4 ipl 2, 

vec OxEO unit 

Aug 31 07:19:21 tonto unix: Root fstype ffs 

Aug 31 07:19:21 tonto unix: Available memory = 29478912 

checking for system core dump... 

Internet daemons: routed snmpd snmptrapd portmap inetd timed (slave) . 

Export file systems 

NFS daemons: nfsd biod lockd statd. 

Aug 31 07:19:32 tonto rpc. statd[ 139] : enter statd_init . 

Aug 31 07:19:32 tonto rpc.statd[139] : 1 

Aug 31 07:19:32 tonto rpc.statd[139] : local state = 1 

Starting Ipd 

The system is ready. 

tonto Console login: 

You now need to modify the /etc/passwd file to set up some accounts properly. /^ 

1) Login as root. Modify /etc/passwd file and REPLACE the line: ^ 

acdm:L..Sa£yBbOYdDti.:21:250:X windowing systems startup :/usr2/X:/usxr/bin/Xll/acdmsh«ll 

with 
xdm: :21:250:X windowing systems startup :/usr/bin/Xll:/usr/bin/Xll/xdmrestart 

2) Add the following line to the end of /etc/passwd file. 

esdemo : : 102 : 102 : ESV Demo Account : /usr/esdemo : /bin/csh 
End of installation. 



c 
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ES/os Domestic/Foreign Tape 2.0 - Scratch Installation 

WARNING: This software installation is a scratch install. Data on the root and /usr parti- 
tions on disk will be lost. Back-up any files that you don't want destroyed. A list of systems 
files you might want to backup are located in Appendix A of the 2.0 Release Notes. 
********************************************^ 

CAUTION: It is recommended that you be the only user logged onto the machine while 
loading this software. 

************************************************************************ 
Get the following from your system manager. Will need later during installation. 

1) System Hostname (found in /etc/local__hostname file) 

2) Netmask 

3) Net address (found in /etc/hosts file) 

4) Domain name for your site 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed 
as shown and entered with a carriage return. 

This installation requires approximately 1.5 hours. There are many places where a time is 
indicated to you can walk away and come back later during the installation. 

To begin installation, insert the ES/os Domestic or Foreign Tape 2.0 into the tape drive, and 
proceed as follows: 

Login as root and make sure everyone else is off the machine. 

Typecd /. 

Shutdown your ESV by typing shutdown -y -g0 -i0. 

E&S CPU Board MIPS Monitor Version 4.10 MIPS OPT Mon Feb 18 15:00:28 MST 

1991 

Copyright 1988, MIPS Computer Systems Inc . f All Rights Reserved 

Memory size: 33554432 (0x2000000) bytes 

Icache size: 65536 (0x10000) bytes 

Dcache size: 65536 (0x10000) bytes 

» boot -f tqis(, ,2) format .std 

128896+31552+206928 entry: 0x80020000 

********** NOTE: The following sequence formats DISK ******** 

MIPS Format Utility 

Version 5.00 Mon Feb 18 15:47:23 MST 1991 

name of device? dkis 

LUN number? 
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target id? I 

vendor: CDC ^ 

product: 94191-15 
Disk has block caching enabled 

device parameters from disk don't match table entries! 
choose new device parameters (y if yes)? y 
Drive has 5061 cylinders 
256 sectors per cylinder 
234 sectors left over 

dump device parameters (y if yes)? <CR> 
modify device parameters (y if yes)? <CR> 

dump partition table (y if yes)? <CR> 
modify partition table (y if yes)? <CR> 

formatting destroys ALL SCSI disk data, perform format (y if yes)? <CR> 

formatting wasn't done, perform scan anyway (y if yes)? <CR> 

SCSI defect list manipulation, when prompted 

choose one of (list, add, delete, quit) 

command? q 

writing volume header... 

exit (0) called 



( 



Note: The following sequence formats DISK 1. Skip this section if you are not formatting 
DISK 1 

************************* *********************************************** 

WARNING: Only perform this sequence at the factory, or if you really want to re-format 
and destroy data on DISK 1 . 

********************************** ************************************** 

E&S CPU Board MIPS Monitor Version 5.00 MIPS OPT Mon Feb 18 15:00:28 MST 
1991 

Copyright 1988, MIPS Computer Systems Inc., All Rights Reserved 
Memory size: 33554432 (0x2000000) bytes 
Icache size: 65536 (0x10000) bytes 
Dcache size: 65536 (0x10000) bytes 
» go 

MIPS Format Utility 

Version 5.00 Mon Feb 18 15:47:23 MST 1991 

name of device? dkis 

LUN number? f 
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target id? 1 
vendor: CDC 
product: 94161-9 

device parameters from disk don't match table entries! 
choose new device parameters (y if yes) ? y 

dump device parameters (y if yes) ? <CR> 
modify device parameters (y if yes)? <CR> 

dump partition table (y if yes)? <CR> 
modify partition table (y if yes)? <CR> 

formatting destroys ALL SCSI disk data, perform format (y if yes) ? <CR> 

formatting wasn't done, perform scan anyway (y if yes)? <CR> 

SCSI defect list manipulation, when prompted 
choose one of (list, add, delete, quit) 
command? q 

writing volume header. . . 
exit(O) called 



End of DISK 1 Formatting Sequence 



E&S CPU Board MIPS Monitor Version 5.00 MIPS OPT Mon Feb 18 15:00:28 MST 

1991 

Copyright 1988, MIPS Computer Systems Inc., All Rights Reserved 

Memory size: 33554432 (0x2000000) bytes 

Icache size: 65536 (0x10000) bytes 

Dcache size: 65536 (0x10000) bytes 

» boot -f tqis(, ,2)sash.std 

120544+23088+170432 entry: 0xa0300000 

MIPS Standalone Shell Version 5.00 MIPS OPT Mon Feb 18 08:39:23 MDT 1991 

sash: cp -b 16k tqis(,,4) dkis(,,l) 



Note : Takes @5 minutes till next user response 
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c 



c 



13824000 (Oxd2fOOO) bytes copied 

Note: The next input determines the OS Kernel you will be installing. There are two to 
choose from. See "OS Kernel Information" located at the beginning of these instal- 
lation notes before typing the next command. 

sash: boot -f tqis (, , 6)un±x.std root=isc0d0sl (non-development systems) 
OR 

sash: boot -f tqis (, , 7 ) uniac . dvlp_jstd root=isc0d0sl (development systems) 

Note: Takes @8 minutes till next user response 

46208+101360+789520 entry: 0x80021000 

CPU: MIPS R3000 Processor Chip Revision: 3.0 

FPU: MIPS R3010 VLSI Floating Point Chip Revision: 4.0 

ES/os Release 2.0 ESV Version R_100 

Total real memory = 33554432 

Available memory = 31170560 

abminit : ARS/HIC not present. 

arsinit: ARS/HIC not present. 

installing VME vector: addr 0x8007FFA4 ipl 2, vec OxEO unit 

Root on dev 0x10 01 , Swap on dev 0x1001 

Root fstype ffs 

New swplo: 26992 swap size: 19272K bytes 

Available memory =29478912 

Miniroot run level 1 

Making miniroot device files for ml20-l system. . . (takes 5 minutes) 
erase = *H, kill = A U, interrupt = *C 
# inst 

Software package installation 

Installation Information: 

This is a SCRATCH install. Data on the root and /usr disks will be lost. 
Packages will be read in from the local Q24 tape drive. 
Machine type: ml20-l 

Is the information above correct? (y n) [y] ? y 

Note: It is not necessary to install a kernel on the miniroot 

The process will take a few minutes. £ 
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Would you like to install the kernel to the miniroot (y n) [n] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 

root — ES/os Standard Root Filesystem 

ml20-l — ES/os m/120, RC3240 Kernel and Devices 

usr — ES/os Standard /usr Filesystem 

usr_help — ES/os Standard /usr help facilities 

usr_dvlp — ES/os Standard /usr Development files (header 

files & libraries) 

usr_terms — ES/os Standard /usr Miscellaneous Terminal descriptions 

cmplrs — MIPS-C Compiler 

cmplrs-bsd43 — MIPS-C 4.3 BSD Include Files and Libraries 

man — ES/os Manual Pages 

bsd43 — ES/os 4.3 BSD Utilities, Include Files and Libraries 

bsd43_troff — ES/os 4.3 BSD Troff Utilities and Libraries 

bsd43_dvlp — ES/os 4.3 BSD Include Files and Libraries 

reconfig — Kernel Binary Reconfiguration Components 

emacs — emacs 

posix — ES/os POSIX P1003.1 Include Files, Commands and Libraries 

uucp — UUCP 

sees — SCCS 

news_readers — News Readers 

games — Games 

mh — mh 



selecting subpackages 



Note : At the factory, only the following subpackages will be installed: root, ml20-l, 
usr, cmplrs, man, and bsd43. These subpackages are REQUIRED. You may 
choose to install any or all of the remaining subpackages depending on your needs 
and how much disk space you have. At this printing the "default" installation uses 
@ 80000 Kbytes. If you install everything available on this tape, you will need 
@ 131000 Kbytes. 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? n -> See CONFIGURATION INFORMATION 

When asked if you want to install a subpackage, please answer with one of 
the following: 

y - Yes, you want to install the subpackage 

n - No, you do NOT want to install the subpackage 

1 - List the contents of the subpackage and ask me again 
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Subpackage root will be installed 
Subpackage ml20-l will be installed 
Subpackage usr will be installed 

Install subpackage usr_help (1 y n) [n] ? n 
Install subpackage usr_dvlp (1 y n) [n] ? n 
Install subpackage usr_terms (1 y n) [n] ? n 
Install subpackage cmplrs (1 y n) [n]? y 
Install subpackage cmplrs~bsd43 (1 y n) [n]? n 
Install subpackage man (1 y n) [n]? y 
Install subpackage bsd43 (1 y n) [n] ? y 
Install subpackage bsd43__troff (1 y n) [n]? n 
Install subpackage bsd43_dvlp (1 y n) [n] ? n 
Install subpackage reconfig (1 y n) [n] ? n 
Install subpackage emacs (1 y n) [n] ? n 
Install subpackage posix (1 y n) [n]? n 
Install subpackage uucp (1 y n) [n] ? n 
Install subpackage sees (1 y n) [n]? n 
Install subpackage news__readers (1 y n) [n] ? n 
Install subpackage games (1 y n) [n] ? n 
Install subpackage mh (1 y n) [n] ? n 

Selected subpackages : 

root ml20-l usr cmplrs man bsd43 

Is this what you want (y n) [y] ? y 



( 



========= setting system clock/calendar 



The current value of the clock is: Thu Aug 30 14:10:44 PDT 1990 
Is the clock correct (y n) [y] ? <CR> 



========== verifying single-user mode ========== 

The system is in a single-user run level. 

Please answer *y" to the following question unless you really understand 
the consequences . 

Do you want to install sash to the volume header (y n) [y] ? <CR> 

========== installing sash to volume header ========== 

========== determining /usr partition ========== 



( 
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Partition Megs Mounted File System or Partition Usage 

3 /dev/dsk/isc0d0s3 578 -**** Available Partition ****- 

4 /dev/dsk/isc0d0s4 376 -**** Available Partition ****- 

5 /dev/dsk/isc0d0s5 188 -**** Available Partition ****- 

6 /dev/dsk/isc0d0s6 564 -**** Available Partition ****- 

Disk Device /dev/dsk/isc0d0s2 632 Megabytes Total Size 

Possible partitions to use are marked by -**** Available Partition ****- 

select either partition 3, 4, 5 or 6 
Which partition should /usr be installed on [6]? <CR> 
/usr partition will be installed on partition 6 



initializing filesystems 



A scratch install of an operating system package is being performed from 
the miniroot. Normally in this case the filesystems are initialized. When 
a filesystem is initialized, any existing data will be lost. You will be 
given a chance to override initialization of each individual filesystem 
below. 

Initialize filesystems (y n) [y] ? <CR> 
Disk type for controller drive [94171]? <CR> 
Initialize filesystem on /dev/root (y n) [y] ? <CR> 
Initialize filesystem on /dev/usr (y n) [y] ? <CR> 



Note: Takes 012 minutes until next user response 



Initializing the filesystem on /dev/root... 

/dev/root: 46080 sectors in 180 cylinders of 1 tracks, 256 sectors 

23.6Mb in 12 cyl groups (16 c/g, 2.10Mb/g, 832 i/g) 
super-block backups (for fsck -b#) at: 

32, 4128, 8224, 12320, 16416, 20512, 24608, 28704, 32800, 36896, 

40992, 45088, 
rotational delay between contiguous blocks changes from 7ms to 0ms 

Checking the filesystem on /dev/root... 

** /dev/root 

** Last Mounted on 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

2 files, 9 used, 21574 free (14 frags, 2695 blocks, 0.1% fragmentation) 
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Initializing the filesystem on /dev/usr..„ 1 

/dev/usr: 1154304 sectors in 4509 cylinders of 1 tracks, 256 sectors 
591.0Mb in 282 cyl groups (16 c/g, 2.10Mb/g r 896 i/g) 

super-block backups (for fsck -b#) at: 
32, 4128, 8224, 12320, 16416, 20512, 24608, 28704, 32800, 36896, 
40992, 45088, 49184, 53280, 57376, 61472, 65568, 69664, 73760, 77856, 
81952, 86048, 90144, 94240, 98336, 102432, 106528, 110624, 114720, 118816, 
122912, 127008, 131104, 135200, 139296, 143392, 147488, 151584, 155680, 

159776, 

163872, 167968, 172064, 176160, 180256, 184352, 188448, 192544, 196640, 
200736, 

204832, 208928, 213024, 217120, 221216, 225312, 229408, 233504, 237600, 
241696, 

245792, 249888, 253984, 258080, 262176, 266272, 270368, 274464, 278560, 
282656, 

286752, 290848, 294944, 299040, 303136, 307232, 311328, 315424, 319520, 
323616, 

327712, 331808, 335904, 340000, 344096, 348192, 352288, 356384, 360480, 
364576, 

368672, 372768, 376864, 380960, 385056, 389152, 393248, 397344, 401440, 
405536, 

409632, 413728, 417824, 421920, 426016, 430112, 434208, 438304, 442400, 
446496, 

450592, 454688, 458784, 462880, 466976, 471072, 475168, 479264, 483360, 
487456, 
rotational delay between contiguous blocks changes from 7ms to 0ms 

Checking the filesystem on /dev/usr... 

** /dev/usr 

** Last Mounted on 

** Phase 1 - Check Blocks and Sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 

** Phase 4 - Check Reference Counts 

** Phase 5 - Check Cyl groups 

2 files, 9 used, 541026 free (10 frags, 67627 blocks, 0.0% fragmentation) 



mounting filesystems 



/dev/root mounted on /mnt 
/dev/usr mounted on /mnt/usr 



Partition Megs Mounted File System or Partition Usage 



/dev/dsk/isc0d0s0 23 /dev/root 

1 /dev/dsk/isc0d0sl 33 / 
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6 /dev/dsk/isc0d0s6 564 /dev/usr 

7 /dev/dsk/isc0d0s7 14 -**** Available Partition ****- 

Disk Device /dev/dsk/isc0d0s2 632 Megabytes Total Size 

Do you wish to change swap partition configuration (y n) [n] ? <CR> 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

Note: Takes @30 minutes til next user response 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming. . . 

There is enough space . 

========== extracting files from subpackage archives ========== 

rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage : root . . . 
Forward spacing the tape... 
Loading subpackage: ml20-l... 
Forward spacing the tape... 
Loading subpackage: usr... 
Forward spacing the tape... 
Loading subpackage : cmplrs . . . 
Forward spacing the tape... 
Loading subpackage : man . . . 
Forward spacing the tape . . . 
Loading subpackage: bsd43... 
Forward spacing the tape... 
rewinding the tape ... 

========== making device special files ========== 



running MKDEV. 
done . 



========== running comply = 

running first comply pass., 
running second comply pass. 
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There were no comply messages from the second pass. 1 

========== doing uncompress Thu Aug 30 15:27:31 PDT 1990 ========== 

uncompress us r /bin/ admin. Z 
uncompress usr/bin/at.Z 

(Uncompresses Occur Here) 

uncompress usr/bin/chkey .Z 
uncompress usr/new/mh/whatnow„Z 
uncompress usr/new/mh/whom.Z 

Once again, before you can type *y' to the next questions, your system 
administrator must provide you with the following info: 

1) System hostname. 

2) Netmask. 

3) Broadcast address. 

4) Net address. 

5) Domain name for your site. 

The following entries are given for example ONLY! 

Do you wish to configure the network (y n) [n] ? y 

========== making special network files ========== 1 

Set hostname [no_ho stname]? tonto 

Set netmask [Oxf f f f 0000] ? OxffffffOO 

Set broadcast address [255.255.255.0]? 130.187.85.0 

Set net address [127.1.0.0]? 130.187.85.156 

Should we create the /etc/local__hostname file (y n) [y] ? y 

tonto 130.187.85.156 

Should we add the above entry to the /etc/hosts file (y n) [y] ? y 

Set domain name [mips.com]? sauria 

Should we create the /etc/local_domainname file (y n) [y] ? y 



========== cleaning up ========== 

Copying packaging information directory to /mnt/usr/pkg/lib/ESos2 . . 
Copying miniroot f stab to installed system. . . 
Unmounting filesys terns ... 
/mnt/usr: Unmounted 
/mnt : Unmounted 



installation complete 



C 
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*********************************************************************** 

WARNING: If this is an LS or Diskless Node Install - **STOP**, do not proceed further 
using these instructions. Instead, go to the Diskless Node 2.0 Installation Instructions and 
continue with the #sync; sync command found in those instructions. 

*********************************************************************** 

# sync; sync 

# telinit 

# 

INIT: New run level: 

Miniroot shutdown 

E&S CPU Board MIPS Monitor Version 5.00 MIPS OPT Mon Feb 18 15:00:28 MST 

1991 

Copyright 1988, MIPS Computer Systems Inc., All Rights Reserved 

Memory size: 33554432 (0x2000000) bytes 

Icache size: 65536 (0x10000) bytes 

Dcache size: 65536 (0x10000) bytes 

» auto - 

Autoboot: Waiting to load dkis (0, 0, 8) sash (CTRL-C to abort, RETURN to 

expedite) <CR> 

loading 

120544+23088+170432 entry: 0xa0300000 

MIPS Standalone Shell Version 5.00 MIPS OPT Mon Feb 18 08:39:23 MDT 1991 

Loading dkis (0, 0, 0) /unix 

846208+101360+789520 entry: 0x80021000 

CPU: MIPS R3000 Processor Chip Revision: 2.0 

FPU: MIPS R3010 VLSI Floating Point Chip Revision: 2.0 

ES/os Release 2.0 ESV Version R_100 

Total real memory = 33554432 

Available memory =311705 60 

abminit: ARS/HIC not present. 

arsinit: ARS/HIC not present. 

installing VME vector: addr 0x8007FFA4 ipl 2, vec OxEO unit 

installing VME vector: addr 0x8007FFA4 ipl 2, vec OxEO unit- 

Root fstype ffs 

Available memory =2 9478 912 • . 



Checking root file system () if necessary. 
The system is coming up. Please wait. 

***** Normally all file systems are fscked. 
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***** To fsck only dirty ones, type *yes f within 5 seconds: \ 

***** All file systems will be fscked. 

/dev/usr: 6199 files, 109289 used, 431746 free (2882 frags, 53608 blocks, 

0.5% fragmentation) 

/dev/usr mounted on /usr 

No process accounting on this system 

Aug 31 07:19:19 tonto unix: CPU: MIPS R3000 Processor Chip Revision: 2.0 

Aug 31 07:19:19 tonto unix: FPU: MIPS R3010 VLSI Floating Point Chip 

Revision: 2.0 

Aug 31 07:19:20 tonto unix: 

Aug 31 07:19:20 tonto unix: Total real memory = 33554432 

Aug 31 07:19:20 tonto unix: Available memory = 31170560 

Aug 31 07:19:20 tonto unix: abminit : ARS/HIC not present. 

Aug 31 07:19:20 tonto unix: arsinit: ARS/HIC not present. 

Aug 31 07:19:21 tonto unix: installing VME vector: addr 0x8007FFA4 ipl 2, 

vec OxEO unit 

Aug 31 07:19:21 tonto unix: installing VME vector: addr 0x8007FFA4 ipl 2, 

vec OxEO unit 

Aug 31 07:19:21 tonto unix: Root fstype ffs 

Aug 31 07:19:21 tonto unix: Available memory = 29478912 

checking for system core dump ... 

Internet daemons: routed snmpd snmptrapd portmap inetd timed (slave) . 

Export file systems 

NFS daemons: nfsd biod lockd statd. 

Aug 31 07:19:32 tonto rpc.statd[139] : enter statd_init 

Aug 31 07:19:32 tonto rpc .statd [139] : 1 

Aug 31 07:19:32 tonto rpc. statd [ 139 ] : local state = 1 

Starting Ipd 

The system is ready. 

tonto Console login: 

You now need to modify the /etc/passwd file to set up some accounts properly. 

1) Login as root. Modify /etc/passwd file and REPLACE the line: 

xdm:L. .SxyBbOydh. :21:250:X windowing systoma startup: /usr 2 /X:/uar/bin/XlX/xdKish«ll 

with 
xdm: : 21 : 250 : X windowing systems startup : /usr/bin/Xll : /usr/bin/Xll/xdmrestart 

2) Add the following line to the end of /etc/passwd file, 
esdemo : : 102 : 102 : ESV Demo Account : /usr/esdemo : /bin/csh 

End of installation. 



( 



c 
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Installation Instructions - ES/PEX Server Tape 2.0 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed 
as shown and entered with a carriage return. 
************ ************************************************************* 

CAUTION: It is recommended that YOU be the only user logged onto the 

machine while loading this software. 
************************************************************************* 
To install this tape, insert the ES/PEX Server Tape 2.0 into the tape drive, login as root, and 
proceed as follows: 

Type cd / 

Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution 

tape, then press return... <CR> 

Rewinding the tape... 

Verifying tape id. . . ok 

Extracting packaging information tree... pexs2.0 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20 

Is the information above correct? (y n) [y] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 

executables_s — PEX 2.0 Executable Release 

library_s — PEX 2.0 Library Release 

pexs-man — PEX 2.0 Man Page Release 

fstest — fstest Release 

xclients_s — PEX 2.0 XClients Release 

pexs-man-unformat — Unformatted Man Page Release 

demo s — Demo_s Release 



selecting subpackages 



You may select all of the above subpackages by answering "y" to the 
following question. If you answer V then you will be asked to select the 
optional subpackages you would like to have installed. 
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Install ALL subpackages (y n) [n] ? SEE CONFIGURATION INFORMATION 
========== setting system clock/calendar ========== 

The current value of the clock is: Fri Mar 22 16:37:04 MST 1991 
Is the clock correct (y n) [y] ? <CR> 



verifying single-user mode 



This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 
========== preserving local files ========== 

Running preserve -s for subpackage executables_s . . . 2 files preserved. 

No preserve list or findmods list for library_s- preserve not executed. 

No preserve list or findmods list for pexs-man- preserve not executed. 

No preserve list or findmods list for fstest- preserve not executed. 

No preserve list or findmods list for xclients_s- preserve not executed. 

No preserve list or findmods list for pexs-man-unformat- preserve not 
executed. 

No preserve list or findmods list for demo_s- preserve not executed. 
========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming... 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage executables_s . . . 
Stripping links for subpackage library_s... 
Stripping links for subpackage pexs-man... 
Stripping links for subpackage fstest... 
Stripping links for subpackage xclients__s . . . 
Stripping links for subpackage pexs-man-unformat . . . 
Stripping links for subpackage demons . . . 



extracting files from subpackage archives === 



rewinding the tape . . . 
Verifying tape id. . . ok 



C 



( 



C 
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Forward spacing the tape... 

Loading subpackage: executables_s . . . 

Forward spacing the tape... 

Loading subpackage: library_s... 

Forward spacing the tape... 

Loading subpackage: pexs-man. . . 

Forward spacing the tape . . . 

Loading subpackage: f stest . . . 

Forward spacing the tape... 

Loading subpackage: xclients_s . . . 

Forward spacing the tape... 

Loading subpackage : pexs-man-unf ormat . . . 

Forward spacing the tape... 

Loading subpackage : demo_s . . . 

Forward spacing the tape... 

rewinding the tape... 

========== running comply ========== 

running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass. 

========== doing uncompress Fri Mar 22 16:54:41 MST 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

NOTE: These messages appear if you have a previous version of ES/PEX Server 
installed on your system. 

Clean up pexs .executables_s 1.3 (y n) [n] ? y 

Removing leftover files from pexs .executables 1.3... 

rm . /usr/bin/Xll/imake 

rm . /usr/bin/Xll/sw 

rm . /usr/bin/Xll/swstart 

Clean up pexs . libra ry_s 1.3 (y n) [n] ? y 

Removing leftover files from pexs . library_s 1.3... 

rm . /usr/lib/Xll/dsp_ucode 

rm . /usr/lib/Xll/fonts/misc/roman.esf 

Clean up pexs .pexs-man 1.3 (y n) [n] ? y 

Removing leftover files from pexs .pexs-man 1.3... 

rm . /usr/man/catman/x man/manl/imake . 1 
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Clean up pexs.fstest 1.3 (y n) [n]? y I 

Removing leftover files f rom pexs .f stest 1.3... 
rm . /usr/people/f stest/diag/esv_sysdiag 

There are no longer any boms present for any subpackages from 
//usr/pkg/lib/pexsl.3 version 1.3. This probably indicates that no 
subpackages installed from this package are still present on the system. 

Remove the packaging information tree for this package (y n) [y] ? y 

========== restoring preserved user files ========== 

Running preserve -r for subpackage executables_s . . . 

No preserve list or findmods list for library_s- no files restored. 

No preserve list or findmods list for pexs-man- no files restored. 

No preserve list or findmods list for fstest- no files restored. 

No preserve list or findmods list for xclients_s- no files restored. 

No preserve list or findmods list for pexs-man-unformat- no files restored. 

No preserve list or findmods list for demo s- no files restored. 



running conversion scripts ========== 

pexs-man. conversion Fri Mar 22 16:55:30 MST 1991 



Manpage Conversion. . . 

x_man exists 

Making P_man -> catman/P_man softlink... 

Done . 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

Your file /usr/lib/X1 1 /pex_conf ig.daf from prior releases has been preserved. However, 
without modification it will not work with the 2.0 Release. 

Before PEX clients can be run, the file /usr/Sib/X1 17pex_config.dat must be modified to up- 
date the MAX__TABLE„ENTRIES in the COLOUR J^PPROXIMATIONJTABLE from to 
256. To do this, find the following lines in the file /usr/lib/pex_config.dat: 

COLOUR_APPROXXMATION__TABLE 
START_INDEX 
MAX_TABLE_ENTRIES 
NUMBER_P REDEFINED 
FIRST_PREDEFINED_INDEX 
LAST PREDEFINED INDEX 
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Change the following line, 

MAX_TABLE_ENTRIES 

to read, 

MAX_TABLE_ENTRIES 256 

Alternately, a default pex_config.dat file has been included in the 2.0 Release. It is called 
pex_config.dat:2.0+ and is located in the same directory. You can rename this file to be 
pex_config.dat However, you should not do this if your original pex_config.dat file has 
been modified for your specific needs. In this case, you should edit your original 
pex_config.dat file as described above. 
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Installation Instructions - ES/PEX Library Tape 2.0 V 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed 
as shown and entered with a carriage return. 

*********************************************************** 

CAUTION: It is recommended that YOU be the only user logged onto the 
machine while loading this software. 

************************************************************************ 

To install this tape, insert the ES/PEX Library Tape 2.0 into the tape drive, login as root, and 
proceed as follows: 

Type cd / 

Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution 

tape, then press return... <CR> 

Rewinding the tape . . . 

Verifying tape id. . . ok 



Extracting packaging information tree... pexl2 . 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml2Q-l 

Is the information above correct? (y n) [y] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 

library_l — PEX 2.0 Library Release 

cdrs_library_l — PEX 2.0 CDRS Library Release 
pexl-man -- PEX 2.0 Man Pages 

pexl-man-unf ormat — PEX 2 . Unformatted Man Pages 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering *y" to the 
following question. If you answer w n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? — > SEE CONFIGURATION INFORMATION 
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========== setting system clock/calendar ========== 

The current value of the clock is: Fri Mar 22 16:51:09 MST 1991 
Is the clock correct (y n) [y] ? y 

===========verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for library_l- preserve not executed. 

No preserve list or findmods list for cdrs_library_l- preserve not 

executed. 

No preserve list or findmods list for pexl-man- preserve not executed. 

No preserve list or findmods list for pexl-man-unformat- preserve not 

executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage library_l... 
Stripping links for subpackage cdrs_library_l . . . 
Stripping links for subpackage pexl-man... 
Stripping links for subpackage pexl-man-unformat . . . 

========== extracting files from subpackage archives ========== 

rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: library_l... 
Forward spacing the tape... 
Loading subpackage: cdrs_library_l. . . 
Forward spacing the tape... 
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Loading subpackage: pexl-man... 

Forward spacing the tape... 

Loading subpackage : pexl-man-unf ormat . . . 

Forward spacing the tape... 

rewinding the tape . . . 

========== running comply ========== 

running first comply pass . . . 

running second comply pass. . . 

There were no comply messages from the second pass . 



========== doing uncompress Fri Mar 22 17:11:36 MST 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any~ files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for library_l- no files restored. 

No preserve list or findmods list for cdrs_library_l- no files restored. 

No preserve list or findmods list for pexl-man- no files restored. 

No preserve list or findmods list for pexl-man-unf ormat- no files restored. 



( 



running conversion scripts ========== 

pexl-man. conversion Fri Mar 22 17:11:54 MST 1991 



Manpage Conversion. . . 

x__man exists 
P__man exists 
m_man exists 

Done. 

========== cleaning up 



Remove install tools (y n) [n] ? y 

========== installation complete = 



C 
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Installation Instructions - ES/PSX Tape 2.0 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed 
as shown and entered with a carriage return. 

CAUTION: It is recommended that you be the only user logged onto the ma- 
chine while loading this software. 

To install this tape, insert the ES/PSX Tape 2.0 into the tape drive, login as root, and proceed 
as follows: 

Typecd / 

Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution 

tape, then press return. . . <CR> 

Rewinding the tape... 

Verifying tape id. . . ok 

Extracting packaging information tree... psx2 . 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20 

Is the information above correct? (y n) [y] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 

psx — PSX 2.0 Release 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 

The current value of the clock is: Wed Sep 26 09:58:24 PDT 1990 
Is the clock correct (y n) [y] ? <CR> 
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========== verifying single-user mode ========== I 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for psx- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really 
understand the consequences) (y n) [y] ? <CR> 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming. . . 

There is enough space. 

If you see this type of error message: 

space: error: fstabindO : couldn't find device file for dev=0xl439 

there is a f ilesystem linked through NFS to another system which must be 
removed before the installation can be performed. 

========== stripping old links ========== 

Stripping links for subpackage psx. . . 

========== extracting files from subpackage archives ========== 

rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: psx... 
Forward spacing the tape... 
rewinding the tape ... 



========== running comply ========== 

running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass. 



doing uncompress Wed Sep 26 10:01:10 PDT 1990 



( 



C 
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========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 
Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for psx- no files restored. 

Remove install tools (y n) [n] ? y 
========== installation complete ========== 
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Installation Instructions - ES/Dnet Tape 2.0 V 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed 
as shown and entered with a carriage return. 

CAUTION: It is recommended that YOU be the only user logged onto the 
machine while loading this software. 

To install this tape, insert the ES/Dnet Tape 2.0 into the tape drive, login as root, and proceed 
as follows: 

Type cd / 

Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution 

tape, then press return... <CR> 

Rewinding the tape . . . 

Verifying tape id. . . ok 



Extracting packaging information tree... esdnet2.0 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20 

Is the information above correct? (y n) [y] ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 
esdnet ■ — ES/Dnet Release 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering w y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 

The current value of the clock is: Thu Oct 4 09:43:52 MDT 1990 
Is the clock correct (y n) [y] ? <CR> 

========== verifying single-user mode ========== 
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This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for esdnet- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming. . . 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage esdnet... 

========== extracting files from subpackage archives ========== 

rewinding the tape. . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: esdnet... 
Forward spacing the tape... 
rewinding the tape... 



========== running comply ========== 

running first comply pass... 

running second comply pass . . . 

There were no comply messages from the second pass. 

========== doing uncompress Thu Oct 4 09:47:18 MDT 1990 

========== cleaning up old versions ========== 



An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 
Clean up esdnet .esdnet 1.3 (y n) [n] ? y 
Removing leftover files from esdnet .esdnet 1.3... 
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There are no longer any boms present for any subpackages from I 

//usr/pkg/lib/esdnetl. 3 version 1.3. ^- 

This probably indicates that no subpackages installed from this package are 
still present on this system. 

Remove the packaging information tree for this package (y n) [y] ? <CR> 
========== restoring preserved user files ========== 

No preserve list or findmods list for esdnet- no files restored. 
========== cleaning up ========== 

Remove install tools (y n) [n]? y 
========== installation complete ========== 



C 



C 
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Installation Instructions - AVS Tape 2.0 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed 
as shown and entered with a carriage return. 

CAUTION: It is recommended that you be the only user logged onto the ma- 
chine while loading this software. 

********************************************** 

To install this tape, insert the AVS Tape 2.0 into the tape drive, login as root, and proceed 
as follows: 

Typecd / 

Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution tape, then press 
return. . . <CR> 
Rewinding the tape. . . 
Verifying tape id. . . ok 

Extracting packaging information tree... avs2 . 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20 

Is the information above correct? (y n) [y] ? y 

========== checking subpackages ========== 

The following subpackages may be installed: 

avs — AVS2 2.0 Release 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 



The current value of the clock is: Tue Apr 2 13:23:28 MST 1991 
Is the clock correct (y n) [y] ? y 
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— . . 

========== verifying single-user mode ========== I 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for avs- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming. . . 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage avs... 

========== extracting files from subpackage archives ========== 



rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape . 

Loading subpackage : avs . . 
Forward spacing the tape, 
rewinding the tape... 



========== running comply ========== 

running first comply pass... 

running second comply pass ... 

There were no comply messages from the second pass. 



( 



========== doing uncompress Tue Apr 2 13:32:23 MST 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... ^- 
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========== restoring preserved user files ========== 

No preserve list or findmods list for avs- no files restored. 

Remove install tools (y n) [n] ? y 
========== installation complete ========== 
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Installation Instructions - ES/Diskless Node Tape 2.0 \^ 

The following instructions should be used for either a "Diskless Node" installation or an "LS 
- Local Server" installation. 

**************************************************** 

CAUTION: It is recommended that you be the only user logged onto the ma- 
chine while loading this software. 

Before this installation is attempted, make sure you have already installed the 
ES/os 2.0, and ES/PEX Server 2.0 tapes on the "Serving" machine. (See in- 
stallation instructions for these particular tapes. 

******************* ***************************************************** 

General Notes 

Diskless Node and Local Server (LS) machines have very similar installation 
procedures. For the LS installation, a "SCPU" prefix will appear at all user 
prompts in the instructions that follow. 

Diskless Node Notes 

The "ES/Diskless Node" tape should be installed on an ES V that will be the 
"Serving" machine for other ES V Diskless Workstations. This "Serving" ma- 
chine should already have had the ES/os 2.0 and ES/PEX Server 2.0 tapes and y- 
any other software options installed prior to attempting this install. f 

LS - Local Server Machine Notes 

The "ES/Diskless Node" tape should be installed on the "SCPU" which is the 
"Serving" CPU. This "Serving" CPU should already have had the ES/os 2.0 
and ES/PEX Server 2.0 tapes and any other software options installed prior 
to attempting this install. 

Disk Space Requirements 

The files on tapes used will require approximately 400 megabytes of disk 
space. This is do to the fact that the ES/os 2.0 tape and the ES/PEX Server 2.0 
tapes will be installed again during this procedure (but in a different location 
on the disk). 

Items needed for Diskless Node/Local Server Installation 

• ES/Diskless Node 2.0 tape 

• ES/os 2.0 tape 

• ES/PEX Server 2.0 tape 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed as 
shown and entered with a carriage return. 



c 
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To install this software, follow these instructions: 

1) Log on as root. 

2) Insert the "ES/Diskless Node" distribution tape into the ESV "Serving" OR the LS ma- 
chine. 

3)Typecd /. 

# sync; sync 

# telinit 

# 

INIT: New run level: 

Miniroot shutdown 

E&S CPU Board MIPS Monitor Version 4.10 MIPS OPT Mon Feb 18 15:00:28 MST 

1991 

Copyright 1988, MIPS Computer Systems Inc., All Rights Reserved 

Memory size: 33554432 (0x2000000) bytes 

Icache size: 65536 (0x10000) bytes 

Dcache size: 65536 (0x10000) bytes 

» boot -f dkis(, ,8) sash 

138896+27152+175024 entry: 0xa0480000 

MIPS Standalone shell Version 5.00 MIPS OPT Mon Feb 18 10:49:00 MST 1991 

sash» boot -f dkis ( ) /unix initarg=s 

869264+103616+894624 entry: 0x80021000 

CPU: MIPS R3000 Processor Chip Revision: 3.0 

FPU: MIPS R3010 VLSI Floating Point Chip Revision: 4.0 

ES/os Release 2.0 ESV Version R_100 

Total real memory = 33554432 

Available memory = 31170560 

abminit: ARS/HIC not present. 

arsinit: ARS/HIC not present. 

installing VME vector: addr 0x8007FBlC ipl 1, vec 0x1 unit 

Root fstype ffs 

Available memory = 6238 617 6 

Checking root file system () if necessary. 

INIT: SINGLE USER MODE 
TERM: (esconsole) <CR> 
# fsck.ffs /dev/usr 

** /dev/usr 

** Last Mounted on /usr 

** Phase 1 - Check Blocks and sizes 

** Phase 2 - Check Pathnames 

** Phase 3 - Check Connectivity 
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** Phase 4 - Check Reference Counts 1 

** Phase 5 - Check Cyl Group 

6201 files, 109993 used, 431042 free (1946 frags, 53637 blocks, 0.4% frag) 

4) Type the following: 

# mount -a 

# mkdir -p /usr/diskless/dl_root 

# /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? /usr/diskle$s/dl_j:oot 

Please mount the (first, if multiple tapes) distribution 
tape, then press return. . . <CR> 
Rewinding the tape... 
Verifying tape id. ... ok 

Extracting packaging information tree... umips-rdiskless2 . 

Installation Information: 



Packages will be read in from the local Q24 tape drive. 
Machine type: ml20 

Is the information above correct? (y n) [y] ? y 

■========== checking subpackages ========== 

The following subpackages may be installed: 

droot -- Diskless root files 
dusr — Diskless usr files 
dvar — Diskless var files 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering w y" to the 
following question. If you answer w n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 

The current value of the clock is: Thu Dec 6 11:13:03 MST 1990 
Is the clock correct (y n) [y] ? y 

========== verifying single-user mode ========== 



( 



( 
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This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for droot- preserve not executed. 
No preserve list or findmods list for dusr- preserve not executed. 
No preserve list or findmods list for dvar- preserve not executed. 



========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space . 

========== stripping old links ========== 

Stripping links for subpackage droot... 
Stripping links for subpackage dusr... 
Stripping links for subpackage dvar. . . 

========== extracting files from subpackage archives ========== 



rewinding the tape . . . 
Verifying tape id. . . ok 
Forward spacing the tape.. 

Loading subpackage : droot . 
Forward spacing the tape.. 
Loading subpackage: dusr.. 
Forward spacing the tape.. 
Loading subpackage: dvar.. 
Forward spacing the tape., 
rewinding the tape . . . 

========== running comply ========== 

running first comply pass... 

running second comply pass . . . 

There were no comply messages from the second pass. 
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========== doing uncompress Thu Apr 6 11:15:25 MST 1991 ========== I 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

No preserve list or findmods list for droot- no files restored. 
No preserve list or findmods list for dusr- no files restored. 
No preserve list or findmods list for dvar- no files restored. 

========== running conversion scripts ========== 

========== droot .conversion Thu Apr 6 11:15:30 MST 1991 ========== 

Diskless Conversion... 

Filesystem Type kbytes use avail %use Mounted on 
/dev/usr ffs 541035 293802 247233 54% /usr 

Kbytes free on the server disk: 247233 

WARNING! When asked whether or not you want to perform the space check 
please answer ""yes" 

Press [RETURN] to continue: <CR> 

You should now install ES/os 2.0. Put ES/os tape 1 in the drive. 

Software package installation 

Please mount the (first, if multiple tapes) distribution 
tape, then press return... <CR> 
Rewinding the tape . . . 
Verifying tape id. . . ok 

Extracting packaging information tree... ESos2 . 

========== checking subpackages ========== 

The following subpackages may be installed: 

root — ES/os Standard Root Filesystem 

ml20-l — ES/os m/120, RC3240 Kernel and Devices 

usr — ES/os Standard /usr Filesystem 

usr_help — ES/os Standard /usr help facilities 

usr_dvlp — ES/os Standard /usr Development files (header 

f iles&libraries) ^r 
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usr_terms — ES/os Standard /usr Miscellaneous Terminal descriptions 

cmplrs — MIPS-C Compiler 

cmplrs-bsd43 —MIPS-C 4.3 BSD Include Files and Libraries 

man — ES/os Manual Pages 

bsd43 — ES/os 4.3 BSD Utilities, Include Files and Libraries 

bsd43_troff — ES/os 4.3 BSD Troff Utilities and Libraries 

bsd43_dvlp — ES/os 4.3 BSD Include Files and Libraries 

reconf ig — Kernel Binary Reconfiguration Components 

emacs — - emacs 

posix —ES/os POSIX P1003.1 Include Files, Commands and Libraries 

uucp — ■ UUCP 

sees — SCCS 

news_readers — News Readers 

games — Games 

mh — mh 



selecting subpackages === 



Note: At the factory, only the following subpackages will be installed: root, ml20-l, 
usr, cmplrs, man, and bsd43. These subpackages are REQUIRED. You may 
choose to install any or all of the remaining subpackages depending on your 
needs and how much disk space you have. At this printing the "default" installa- 
tion uses @ 80000 Kbytes. If you install everything available on this tape, you will 
need® 13 1000 Kbytes. 



You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? n -> SEE CONFIGURATION INFORMATION 

When asked if you want to install a subpackage, please answer with one of 
the following: 

y - Yes, you want to install the subpackage 

n - No, you do NOT want to install the subpackage 

1 - List the contents of the subpackage and ask me again 

Subpackage root will be installed 
Subpackage ml20-l will be installed 
Subpackage usr will be installed 

Install subpackage usr_help (1 y n) [n] ? n 
Install subpackage usr_dvlp (1 y n) [n] ? n 
Install subpackage usr_terms (1 y n) [n] ? n 
Install subpackage cmplrs (1 y n) [n] ? y 
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Install subpackage cmplrs-bsd43 (1 y n) [n] ? n 1 

Install subpackage man (1 y n) [n] ? y 

Install subpackage bsd43 (1 y n) [n]? y 

Install subpackage bsd43_troff (1 y n) [n] ? n 

Install subpackage bsd43_dvlp (1 y n) [n]? n 

Install subpackage reconfig (1 y n) [n] ? n 

Install subpackage emacs (1 y n) [n]? n 



Install subpackage posix (1 y n) [n]? n 
Install subpackage uucp (1 y n) [n] ? n 
Install subpackage sees (1 y n) [n] ? n 
Install subpackage news_readers (1 y n) [n] ? n 
Install subpackage games (1 y n) [n]? n 
Install subpackage mh (1 y n) [n] ? n 



Selected subpackages : 

root ml20-l usr cmplrs man bsd43 

Is this what you want (y n) [y] ? y 



preserving local files 



Running preserve -s for subpackage root... files preserved. 

No preserve list or findmods list for ml20-l- preserve not executed. 

Running preserve -s for subpackage usr. . . files preserved. 

No preserve list or findmods list for cmplrs- preserve not executed. 

No preserve list or findmods list for man- preserve not executed. 

No preserve list or findmods list for bsd43- preserve not executed. 

========== verifying disk space ========== 



( 



Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space . 

========== stripping old links ========== 



Stripping links for subpackage root... 

Stripping links for subpackage usr... 

Stripping links for subpackage cmplrs... 

Stripping links for subpackage man... 

Stripping links for subpackage bsd43... 

========== extracting files from subpackage archives ========== ^ 
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rewinding the tape. . . 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage : root . . . 
Forward spacing the tape... 
Forward spacing the tape... 
Loading subpackage: usr... 
Forward spacing the tape... 
Loading subpackage: cmplrs... 
Forward spacing the tape... 
Loading subpackage : man . . . 
Forward spacing the tape... 
Loading subpackage: bsd43... 
Forward spacing the tape... 
rewinding the tape... 

========== running comply ========== 

running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass. 

z=ssssssss=ss==s= do i n g uncompress Thu Dec 6 12:24:25 MST 1990 



uncompress usr/bin/acctcom.Z 
uncompress usr/bin/admin.Z 
uncompress usr/bin/at.Z 

. (Uncompresses Occur Here) 

uncompress usr/new/mh/rmm.Z 
uncompress usr/new/mh/scan.Z 
uncompress usr/new/mh/send.Z 
uncompress usr/new/mh/sortm. Z 
uncompress usr/new/mh/vmh.Z 
uncompress usr/new/mh/whatnow.Z 
uncompress usr/new/mh/whom. Z 

========== cleaning up old versions 



An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 

Running preserve -r for subpackage root... 
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Running preserve -r for subpackage usr... I 

No preserve list or findmods list for cmplrs- no files restored. 
No preserve list or findmods list for man- no files restored. 
No preserve list or findmods list for bsd43- no files restored. 

========== running conversion scripts ========== 

========== root. f stab Thu Apr 4 12:33:27 MST 1991 ========== 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

Are you going to use ES/PEX on any of the clients? (y n) [y] ? y 

You should now install ES/PEX Server 2.0. Put the ES/PEX Server tape in the 
drive . 

Software package installation 

Please mount the (first, if multiple tapes) distribution 
tape, then press return... <CR> 
rewinding the tape. 
Verifying tape id. . . ok 



C 



Extracting packaging information tree... pexs2 . 

========== checking subpackages ========== 

The following subpackages may be installed: 

executables__s — - PEX 2 . Executable Release 

library_s — PEX 2.0 Library Release 

pexs-man — PEX 2 . Man Page Release 

fstest -- fstest Release 

xclients_s — PEX 2.0 XClients Release 
pexs-man-unformat — Unformatted Man Page Release 

demo_s — Demo_s Release 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering "y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? — > SEE CONFIGURATION INFORMATION 

========== setting system clock/calendar ========== 

--------- C 
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Is the clock correct (y n) [y] ? y 

========== verifying single-user mode ========== 

This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

Running preserve -s for subpackage executables_s . . . 2 files preserved. 

No preserve list or findmods list for library_s- preserve not executed. 

No preserve list or findmods list for pexs-man- preserve not executed. 

No preserve list or findmods list for fstest- preserve not executed. 

No preserve list or findmods list for xclients_s- preserve not executed. 

No preserve list or findmods list for pexs-man-unformat- preserve not 

executed. 

No preserve list or findmods list for demo_s- preserve not executed. 



========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages), this can be time consuming... 

There is enough space. 

========== stripping old links ========== 

Stripping links for subpackage executables_s . . . 

Stripping links for subpackage library_s... 

Stripping links for subpackage pexs-man. . . 

Stripping links for subpackage fstest... 

Stripping links for subpackage xclients_s . . „ 

Stripping links for subpackage pexs-man-unformat... 

Stripping links for subpackage demo_s . . . 



========== extracting files from subpackage archives ========== 

rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: executables_s . . . 
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Forward spacing the tape... 1 

Loading subpackage: library_s... 

Forward spacing the tape... 

Loading subpackage: pexs-man... 

Forward spacing the tape... 

Loading subpackage : f stest ... 

Forward spacing the tape... 

Loading subpackage: xclients_s . . . 

Forward spacing the tape... 

Loading subpackage : pexs-man-un format ... 

Forward spacing the tape... 

Loading subpackage : demo_s . . . 

Forward spacing the tape... 
rewinding the tape . . . 

========== running comply ========== 

running first comply pass... 

running second comply pass. . . 

There were no comply messages from the second pass . 

========== doing uncompress Fri Mar 22 16:54:41 MST 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

NOTE: These messages appear if you have a previous version of ES/PEX 
Server installed on your system. 

Clean up pexs .executables_s 1.3 (y n) [n] ? y 

Removing leftover files from pexs .executables 1.3... 

rm ./usr/bin/Xll/imake 

rm ./usr/bin/Xll/sw 

rm ./usr/bin/Xll/swstart 

Clean up pexs .library_s 1.3 (y n) [n] ? y 

Removing leftover files f rom pexs .libra ry_s 1.3... 

rm ./usr/lib/Xll/dsp_ucode 

rm . /usr/lib/Xll/fonts/misc/roman.esf 

Clean up pexs .pexs-man 1.3 (y n) [n]? y 

Removing leftover files from pexs .pexs-man 1.3... 

rm . /usr/man/catman/x_man/manl/imake. 1 

Clean up pexs. f stest 1.3 (y n) [n]? y 

Removing leftover files from pexs. f stest 1.3... 

rm ./usr/people/fstest/diag/esv_sysdiag X~~ 
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There are no longer any boms present for any subpackages from 
//usr/pkg/lib/pexsl.3 version 1.3. 

This probably indicates that no subpackages installed from this package are 
still present on the system. 

Remove the packaging information tree for this package (y n) [y] ? y 

========== restoring preserved user files ========== 

Running preserve -r for subpackage executables_s . . . 

No preserve list or findmods list for library_s- no files restored. 

No preserve list or findmods list for pexs-man- no files restored. 

No preserve list or findmods list for fstest- no files restored. 

No preserve list or findmods list for xclients_s- no files restored. 

No preserve list or findmods list for pexs-man-unf ormat- no files restored. 

No preserve list or findmods list for demo_s- no files restored. 

========== running conversion scripts ========== 

======== === pexs-man. conversion Fri Mar 22 16:55:30 MST 1991 ========== 

Manpage Conversion... 

x_man exists 

Making P_man -> catman/P_man softlink... 

Done. 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 
========== installation complete ========== 

Fixing up all the directories and links... 

mv: usr/Xll/etc: No such file or directory 

In: Symbolic link . . / . . /var/Xll_etc to usr/Xll/etc: No such file or 

directory 

Doing comply for ES/os 2.0 files and directories... 

Comply Pass 1... done. 
Comply Pass 2... done. 

Doing comply for ES/PEX 2.0 files and directories... 

Comply Pass 1... done. 
Comply Pass 2... done. 

No comply errors. 

Building diskless database directory and files... 
Done . 
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========== cleaning up ========== I 

Remove install tools (y n) [n] ? y 
========== installation complete ========== 

# cd /usr/d±sklessDB 

# . /client . setup 

MIPS diskless client installation 

The following user entries are for example ONLY! 
Operation (add clone modify move del) [add]? acid 
New Client Machine Name? []? toddler 

Is this client the gcpu of an LS system (y n) [n]? y 

Enter toddler's inet address [130 . 62 .10 .xx] 130.62.10.35 

Adding toddler to /etc/hosts. 

Mode (master slave client none) [none]? none 

Note: Your swap space size should be twice the physical memory of the 
Client . 

Swap Space Size [32M]? 32M 

Client Root Directory [/usr/diskless/clients/toddler] ? <CR> 

Client Swap File Directory [/usr/diskless/clients/toddler]? <CR> 

Client Dump File Directory [/usr/diskless/clients/toddler]? 

Read Only usr Directory [/usr/diskless/dl_usr] ? <CR> 

Building environment for toddler. 

Copying root directory... done. 

Copying var directory... done. 

Creating swap file... done. 

Building devices . . . done . 

Copying /etc/hosts for toddler 

Creating etc/f stab for toddler 

Creating etc/local_hostname for toddler 

Adding toddler to /etc/bootparams 

Adding toddler to /usr/etc/exports 

running /usr/etc/exportf s . . . 
exported /usr/diskless/dl_usr 
exported /usr/diskless/clients/toddler 
done. 

Creating link in /tftpboot for toddler 

Starting /etc/rpc.bootparamd. . . done. 

# sync; sync f 
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# telinit 

» auto (follow normal boot procedure at this point) 

Autoboot : waiting to load lcs () tftboot/gcpu (CTRL-C to abort, RETURN to 
expedite) <CR> 

For LS Systems, you will need to boot the second CPU the same as above. 



You now need to modify the /etc/passwd file to set up some accounts properly. 

1) Login as root. Modify /etc/passwd file and REPLACE the line: 

xdm: L . . SxyBbOydh . : 21 : 250 : X windowing systems 
startup: /usr2/X: /usr/bin/Xll/xdmsholl 

with 

xdm: : 21 : 250 : X windowing systems 

startup : /usr/bin/Xll : /usr/bin/Xll/xdmrestart 

2) Add the following line to the end of /etc/passwd file, 
esderao: :102:102:ESV Demo Account : /usr/esdemo : /bin/csh 



End of installation. 
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Installation Instructions - ES/Kodak Printer Tape 2.0 V 

In the following procedure, system output is shown in typewriter normal font, and 
user responses are shown in typewriter bold font. All user responses should be typed 
as shown and entered with a carriage return. 

CAUTION: It is recommended that YOU be the only user logged onto the 
machine while loading this software. 

••••it************************************************* ****************** 

To install this tape, insert the ES/Kodak Printer Tape 2.0 into the tape drive, login as root, 
and proceed as follows: 

Type cd / 

Type /usr/pkg/bin/inst 

Software package installation 

Install package relative to where [/]? <CR> 

Please mount the (first, if multiple tapes) distribution 

tape, then press return... <CR> 

Rewinding the tape . . . 

Verifying tape id. . . ok 
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Extracting packaging information tree... kodak2 . 

Installation Information: 

Packages will be read in from the local Q24 tape drive. 
Machine type: ml20-l 

Is the information above correct? (y n) [yj ? <CR> 

========== checking subpackages ========== 

The following subpackages may be installed: 
kodak —-Kodak 2.0 Release 

========== selecting subpackages ========== 

You may select all of the above subpackages by answering *y" to the 
following question. If you answer "n" then you will be asked to select the 
optional subpackages you would like to have installed. 

Install ALL subpackages (y n) [n] ? y 

========== setting system clock/calendar ========== 

The current value of the clock is: Wed Apr 10 13:25:26 MDT 1991 
Is the clock correct (y n) [y]? <CR> 

========== verifying single-user mode ========== ^ 
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This system is not presently in a single-user run level. Installation of a 
package can fail if performed at this run level. We recommend that the 
system be brought to a single user run level (using "init S") prior to 
performing the installation. 

Are you absolutely sure you wish to continue (y n) [n] ? y 

========== preserving local files ========== 

No preserve list or findmods list for kodak- preserve not executed. 

========== verifying disk space ========== 

Do you want to check for space (please do so unless you really understand 
the consequences) (y n) [y] ? y 

The system will now be checked to verify that there is enough disk space 
with the current configuration to successfully install the package (and any 
selected optional subpackages) . For large packages (especially operating 
system packages) , this can be time consuming. . . 

There is enough space . 

========== stripping old links ========== 

Stripping links for subpackage kodak... 

========== extracting files from subpackage archives ========== 



rewinding the tape... 
Verifying tape id. . . ok 
Forward spacing the tape... 

Loading subpackage: kodak... 
Forward spacing the tape... 
rewinding the tape... 



========== running comply ========== 

running first comply pass... 

running second comply pass... 

There were no comply messages from the second pass. 



========== doing uncompress Wed Apr 10 13:25:26 MDT 1991 ========== 

========== cleaning up old versions ========== 

An attempt will now be made to clean up any files left over from previous 
versions of the software which has just been installed. 

Searching for old versions to remove... 

========== restoring preserved user files ========== 
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No preserve list or findmods list for kodak- no files restored. I 

========== cleaning up ========== 

Remove install tools (y n) [n] ? y 

========== installation complete ========== 

To configure the SCSI printer device for the Kodak printer, type the following while logged 
on as root: 

mknod /dev/scsi/pr inter c 16 80; chmod 666 /dev/scsi/printer 
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A. 1 .3 to 2.0 C Binding Conversion 



Introduction 



There have been extensive changes in the PHIGS C binding between the 
1.3 Release and the 2.0 Release. These changes have been made to keep the 
ES V Workstation 2.0 Release current with the PEX-SI releases. The C bind- 
ing to PHIGS will continue to change until the binding is adopted as a formal 
standard; therefore, these kinds of changes will continue to occur with future 
releases of the PEX-SI. 

If you want to run PHIGS programs written with thel.3 C binding, you 
have two options: 

• If you choose not to convert your 1 .3 C code, the 2.0 Release provides 
a "thin layer" 1.3 C binding which allows you to rebuild existing 1.3 
PHIGS programs with minimal effort. The thin layer will increase the 
size of the executable image. Currently, Evans & Sutherland will con- 
tinue support for the thin layer, but if support is terminated, customers 
will be informed of this decision at least six months in advance. 

• If you choose to convert your L3 C code, the information in this ap- 
pendix will assist you in the process of converting source code from 
the 1.3 C binding to the 2.0 C binding. Some of the hints provided will 
require you to manually change the source code. Shell scripts are pro- 
vided which will replace old function names with the new function 
names. 

You should read through this appendix before converting any code to the 
2.0 C binding or using the thin layer. On-line 2.0 PHIGS manual pages are 
provided with the 2.0 Release. These new manual pages will assist you in 
solving problems that the compiler will identify when your source code is 
rebuilt. A list of the PHIGS/PHIGS PLUS function names together with the 1.3 
and 2.0 C binding names will be found at the end of this appendix. 
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Running the 1.3 C Thin Layer 

1) Change all include references from <X1 1/extensions/phigs.h> to 
<X11/phigs1.3/phigs.h> 

2) All parts of the Popenpexlnfo structure need to be defined before the 
popenpex call is made. Most of the sample programs only defined part 
of the elements. 

Popenpexlnfo xlnfo; 

xinfo.display = dpy (or NULL); 

xlnfo.rdb = NULL; 

xlnfo. name = ""; 

xlnfo.classname = ""; 

xinfo.argc_p = NULL; 

xinfo.flags.no_ monitor = True (or False); 

xlnfo jlags.force_client_SS = False; 

popenpex((Pchar *)NULL, PDEFAULT_MEM_SIZE, &xlnfo); 

If you don't define everything, you will get a bus error. All of these 
fields may be used by the application, but if they 're not, they need to be 
set as above. 

3) In the Makefile, add libPEXaph .3.a (-IPEXaph .3) in front of 
libPEXapi.a(-IPEXapl). 

4) Change Makefile references from iibXtR3.a to libXt.a. 

5) If necessary, adjust text positions to make them correct. The 2.0 API 
fixes a bug in the 1.3 server which always reported string length to be 
one greater than the correct value. This slightly affects the position of 
centered text. 

Converting to the 2.0 C Binding 

1) Most routine names have changed. 

2) Most enumerated types have changed. 

3) Change Makefile references from HbXtR3.a to iibXLa. 

4) The number of parameters has changed for ppolylineS, ppoIymarker3, 
fillareaS, and gdp3. They used to have two parameters (number of 
points and list of points), but now have one parameter: 

typedef struct { 

Pint numjoints; 
Ppoint3 "points.; 

} PpointJist3; 

The same holds true for the 2D calls. /^ 
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5) The Plimit(3) structure was: 

typedef struct { 

Pfloat xmin; 
Pfloat xmax; 
Pfloat ymln; 
Pfloat ymax; 
Pfloat zmin; 
Pfloat zmax; 

} Pllmlt3 

It is now: 

typedef struct { 

Pfloat x_mln; 
Pfloat x_max; 
Pfloat y_mln; 
Pfloat y_max; 
Pfloat z_mln; 
Pfloat z_max; 
} PlimltS 

6) Names of elements of structures have changed for 
set_vlew_representatlon(3),evaluate_vlew__orlentatlon_matrlx(3), 
and evaluate_vlewjnapplng_matrlx(3). 

7) Pcolr_bundl is now Pcolr_rep, and Pcolr_rep is a different structure: 

typedef union { 

Prgb rgb; 
Pcieluv cieluv; 
Phis his; 
Phsv hsv; 
Pdata unsupp; 
} Pcolrjep 

All of the types inside are new and different from 1.3. 

8) PvectorS is now Pvec3: 

typedef struct { 

Pfloat delta_x; 

Pfloat delta_y; 

Pfloat delta_z; 

} Pvec3; 

9) flllarea3wlthdata doesn't exist in 2.0. You should now use 
fill area set3 data. 



2.0 Release Notes A - 3 



1 .3 to 2.0 C Binding Conversion 



10) PWAIT has been changed to PDEFER_WAIT. There is also a system 
variable called PWAIT, If the PHIGS PWAIT is not changed you will get 
very interesting errors when the routine is run. If your PHIGS program 
was using the PWAIT system type, then you need to make sure that 
doesn't get changed to PDEFERJAfAIT by running the script. 

1 1) pinqhlhsrfacll is now two routines: pinqjilhsr Jd_facs and 
pinqJilhsr_mode_facs. 

12) If necessary, adjust text positions to make them correct. The 2.0 API 
fixes a bug in the 1.3 server which always reported string length to be 
one greater than the correct value. This slightly affects the position of 
centered text. 

13) This list is not exhaustive, but it contains some of the changes in the 2.0 
Release. Most of the remaining changes will be flagged by the compiler. 

2.0 Conversion Script 

A script is available to assist you in converting from the 1.3 C binding to the 
2.0 C binding. The script is located in the /usr/src/sampfes/tools directory, 
and it will do the following: 

• Change the 1.3 routine names to the 2.0 routine names 

• Change 1 .3 enumerated types to 2.0 enumerated types 

• Change 1.3 #deflnes to 2.0 #defines 

• Flag all routines that had a parameter list change with a #### at the 
end of the line ! 

To run the script, enter the following command: 

convZ0P4rH/1.3file 

where PATH is the path to the file 1 .3f He. The converted program will be put 
into the file 1 .3f lle.out If you move the program from the 
/usr/src/samples/fools directory where it is currently located, you need to 
move the following four files with it: conv2.0.list1 , conv2.0.list2, 
conv2.0.llst3, and conv2.0.llst4. 

Caution: Do not delete your 1.3 program until you are 
absolutely sure that the 2.0 conversion is 
complete and the program is running 
correctly. 
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List of #defines with Changes 

1.3 Binding 2.0 Binding 

PRGB PMODEL_RGB 

PCIE PMODEL_CIELUV 

PHSV PMODELJ4SV 

PHLS PMODEL.HLS 

PLN_DOTDASH PLINE_DOT_DASH 

PMK_POINT PMARKER_DOT 

PMK_PLUS PMARKER_PLUS 

PMK_STAR PMARKER_ASTERISK 

PMK_0 PMARKER_CIRCLE 

PMK_X PMARKER_CROSS 

PANJJNCON PANNO_STYLE_UNCONNECTED 

PAN LEADLINE PANNO STYLE LEAD LINE 
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Enumerated Types with Changes 

PWORKSTATIONJNDEPENDENT 

PWORKSTAT!ON_DEPENDENT 

PPHCL 

PPHOP 

PWSCL 

PWSOP 

PSTCL 

PSTOP 

PSTAT_NON_EXISTENT 

PSTAT_EMPTY 

PSTAT_NON_EMPTY 

PARCL 

PAROP 

PVECTOR 

PRASTER 

POTHER 

POUTPUT 

PINPUT 

POUTIN 

PMO 

PMI 

PCONDITIONALLY 

PALWAYS 

PPOSTPONE 

PPERFORM 

PASAP 

PBNIG 

PBNIL 

PASTI 

PWAIT 

PD«STG_NO 

PDISTGJfES 

PCULL_NONE 

PCULL_BACKFACE 

PCULL_FRONTFACE 

PNIVE 

PUWOR 

PUQUM 

PNOMORE 

PMORE 

PCSS 

PARCHIVE 

PDSJEMPTY 

PDS_NOTEMPTY 

PCORRECT 

PDEFERRED 
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PWSJNDEP 

PWS_DEP 

PSYS_ST_PHCL 

PSYS_STJPHOP 

PWS__ST_WSCL 

PWS_ST_WSOP 

PSTRUCT_ST_STCL 

PSTRUCTST_STOP 

PSTRUCT_STATUS_NON_EXISTENT 

PSTRUCT_STATUS_EMPTY 

PSTRUCT_STATUS__NON_EMPTY 

PSTARCL 

PST_AROP 

PCLASS_VEC 

PCLASS_RASTER 

PCLASS_OTHER 

PCAT_OUT 

PCATJN 

PCAT__OUTIN 

PCAT.MO 

PGATJl 

PFLAGJXJND 

PFLAG_ALWAYS 

PUPD_POSTPONE 

PUPD_PERFORM 

PDEFER_ASAP 

PDEFER_BNIG 

PDEFERJBNIL 

PDEFER_ASTI 

PDEFER_WAiT 

PD8STSNG_NO 

PDIST1NG_YES 

PCULL_NONE 

PCULL_BACKFACE 

PCULL_FRONTFACE 

PMODE_NIVE 

PMODEJJWOR 

PMODEJJQUM 

PSIMULT_NO_MORE 

PSIMULTMORE 

PNET_CSS 

PNET_ARCHIVE 

PSURF_EMPTY 

PSURF__NOT_EMPTY 

PVISUAL__STCORRECT 

PVISUAL ST DEFER 
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PSIMULATED 

PPSTRING 

PPCHAR 

PPSTROKE 

PTP_RIGHT 

PTP_LEFT 

PTPJJP 

PTP_DOWN 

PAH_NORMAL 

PAHJ.EFT 

PAH_CENTRE 

PAHJHGHT 

PAV_NORMAL 

PAVJTOP 

PAV_CAP 

PAV_BASE 

PAV_BOTTOM 

PAVJHALF 

PHOLLOW 

PSOLID 

PPATTERN 

PHATCK 

PEMPTY 

PEDGE_OFF 

PEDGE_ON 

PLINETYPE 

PLINEWIDTH_SCALE_FACTOR 

PPOLYLINE_COLOUR_INDEX 

PMARKERTYPE 

PMARKERSIZE_SCALE_FACTOR 

PPOLYMARKER_COLOURJNDEX 

PTEXT_FONT 

PTEXT_PRECISION 

PCHARACTER_EXPANSION_FACTOR 

PCHARACTER_SPACING 

PTEXT_COLOUR_INDEX 

PINTERIOR_STYLE 

PINTERIOR_STYLE_INDEX 

PINTERIOR_COLOURJNDEX 

PEDGE_FLAG 

PEDGETYPE 

PEDGEWIDTH_SCALE_FACTOR 

PEDGE_COLOUR_INDEX 

PPOLYLINE_SHADING_METHOD 

PAREA_PROPERTIES 

PINTERIOR_REFLECTANCE_EQUATION 

PINTERIOR_SHADING_METHOD 

PBACK INTERIOR STYLE 



PVISUAL_ST_SIMULATED 

PPREC_STRING 

PPREC_CHAR 

PPREC_STROKE 

PPATH_RIGHT 

PPATH_LEFT 

PPATH_UP 

PPATH_DOWN 

PHOR_NORM 

PHOR_LEFT 

PHOR_CTR 

PHORJMGHT 

PVERTJJORM 

PVERTJOP 

PVERT_CAP 

PVERT_BASE 

PVERTJBOTTOM 

PVERT_HALF 

PSTYLE_HOLLOW 

PSTYLE_SOLID 

PSTYLE_PAT 

PSTYLEJriATCH 

PSTYLE_EMPTY 

PEDGE_OFF 

PEDGE_ON 

PASPECT_LINETYPE 

PASPECT_LINEWIDTH 

PASPECT_LINE_COLRJND 

PASPECT_MARKERTYPE 

PASPECT_MARKERSIZE 

PASPECT_MARKER_COLRJND 

PASPECT_TEXT_FONT 

PASPECTJEXTJPREC 

PASPECT_CHAR_EXPAN 

PASPECT_CHAR_SPACE 

PASPECT_TEXT_COLRJND 

PASPECTJNT_STYLE 

PASPECTJNT_STYLE_IND 

PASPECTJNTCOLRJND 

PASPECT_EDGE_FLAG 

PASPECT_EDGETYPE 

PASPECT_EDGEWIDTH 

PASPECT_EDGE_COLR_IND 

PASPECT_LINE_SHAD_METH 

PASPECT_REFL_PROPS 

PASPECTJNT_REFL_EQN 

PASPECT_INT_SHAD_METH 

PASPECT BACK INT STYLE 
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PBACKJNTERBOR_STYLEJNDEX 

PBACKJNTERIORJXJLOUR 

PBACKAREA_PROPERTIES 

PBACKJNTERIORJ*EFLECTANCE_EQUATlON 

PBACKJNTERiOR_SHADING_METHOD 

PCURVE_APPROXIMATION_CRITERIA 

PSURFACE^APPROXIMATION^CRITERIA 

PBUNDLED 

PINDIVIDUAL 

PCOLOUR 

PMONOCHROME 

PPRECONCATENATE 

PPOSTCONCATENATE 

PREPLACE 

PPARALLEL 

PPERSPECTWE 

PCLIP 

PNOCLIP 

PHIGHER 

PLOWER 

PMA1NTAIN 

PABANDON 

PUPDATE 

PPF_POLYLINE 

PPFJFILLAREA 

PPF„FILLAREA„SET 

PTOP_HRST 

PBOTTOMJ=IRST 

PREQUEST 

PSAMPLE 

PEVENT 

PES_ECHO 

PESJIOECHO 

PSTATJDK 

PSTAT.NONE 

PSTRUCT.NONE 

PSTRUCTJDPEN 

PI_NONE 

PI_LOCATOR 

PI_STROKE 

PLVALUATOR 

PLCHOSCE 

PLPICK 

PLSTRING 

PPR_OFF 

PPR_ON 

PSET 

PREALIZED 



PASPECT_BACKJNT_STYLEJND 

PASPECT_BACKJNT_COLR 

PASPECT_BACK__REFL_PROPS 

PASPECT_BACKJNT_REFL_EQN 

PASPECT_BACKJNT_SHAD_METH 

PASPECT_CURVE_APPROX__CRIT 

PASPECT_SURF_APPROX_CRIT 

PASFJBUNDLED 

PASFJNDIV 

PAVAIL_COLR 

PAVAIL_MONOCHR 

PTYPE_PRECONCAT 

PTYPE_POSTCONCAT 

PTYPE_REPLACE 

PTYPEPARAL 

PTYPE__PERSPECT 

PIND_CLIP 

PIND_NO_CLIP 

PPRI_HIGHER 

PPRi_LOWER 

PRES_MAINTAIN 

PRES_ABANDON 

PRESJJPD 

PFLAGJJNE 

PFLAGJ=ILL 

PFLAG_FILL_SET 

PORDER_JOP_FIRST 

PORDER_BOTTOMJ=IRST 

POP__REQ 

POP_SAMPLE 

POP_EVENT 

PSWITCH_ECHO 

PSWITCH_NOJECHO 

PIN__STATUS_OK 

PIN_STATUS__NONE 

PSTRUCTNONE 

PSTRUCT_OPEN 

PIN_NONE 

PIN_LOC 

PIN_STROKE 

PIN_VAL 

PIN_CHOICE 

PIN_PICK 

PIN__STRING 

PPR__OFF 

PPR_ON 

PINQ_SET 

PINQ REALIZED 
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PNOTPENDING 

PPENDING 

PDC_METERS 

PDCJDTHER 

PIRG 

PIMM 

PCBS 

PPOLYLINE 

PPOLYMARKER 

PTEXT 

PINTERIOR 

PEDGE 

PEL_NIL 

PEL_POLYLINE3 

PEL_POLYLINE 

PEL_POLYMARKER3 

PEL_POLYMARKER 

PEL_TEXT3 

PELTEXT 

PEL_ANNOTATION_TEXT_RELATIVE3 

PEL_ANNOTATION_TEXT_RELATIVE 

PEL_RLL_AREA3 

PEL_FILL„AREA 

PEL_FILL_AREA_SET3 

PEL_HLL_AREA_SET 

PEL_CELL_ARRAY3 

PEL_CELL_ARRAY 

PEL_GDP3 

PEL_GDP 

PEL_POLYLINE_INDEX 

PEL_POLYMARKER_INDEX 

PEL_TEXTJNDEX 

PELJNTERIORJNDEX 

PELJEDGEJNDEX 

PEL_LINETYPE 

PEL_LINEWIDTH_SCALE_FACTOR 

PEL_POLYL!NE_COLOURJNDEX 

PEL_MARKER_TYPE 

PEL_MARKER_SIZE_SCALE_FACTOR 

PEL_MARKER_COLOUR_INDEX 

PEL_TEXT_FONT 

PEL_TEXT_PRECISION 

PEL_CHARACTER_EXPANSION_FACTOR 

PEL_CHARACTER_SPACING 

PEL_TEXT_COLOURJNDEX 

PEL_CHARACTER_HEIGHT 

PEL_CHARACTER_UP_VECTOR 

PEL TEXT PATH 



PUPDNOT.PENDING 

PUPDJ>ENDING 

PDC_METRES 

PDCOTHER 

PDYNJRG 

PDYNJMM 

PDYN_CBS 

PATTRJ.INE 

PATTR_MARKER 

PATTR_TEXT 

PATTRJNT 

PATTR_EDGE 

PELEM_NIL 

PELEM_POLYLINE3 

PELEM_POLYLINE 

PELEM_POLYMARKER3 

PELEM_POLYMARKER 

PELEM_TEXT3 

PELEMJTEXT 

PELEM_jANNO_TEXT_REL3 

PELEM_ANNOJTEXT_REL 

PELEM_FILL_AREA3 

PELEMJ=ILL_AREA 

PELEMJFILL_AREA_SET3 

PELEM_FILL_AREA_SET 

PELEM_CELL_ARRAY3 

PELEM_CELL_ARRAY 

PELEM_GDP3 

PELEMJ3DP 

PELEM_LINEJND 

PELEM_MARKERJND 

PELEM_TEXTJND 

PELEMJNTJND 

PELEM_EDGEJND 

PELEMJJNETYPE 

PELEM_LINEWIDTH 

PELEMJJNE_COLRJND 

PELEM_MARKER_TYPE 

PELEM_MARKER_SIZE 

PELEM_MARKER_COLR_IND 

PELEMJTEXTJFONT 

PELEM_TEXT_PREC 

PELEM__CHARJEXPAN 

PELEM_CHAR__SPACE 

PELEM_TEXT_COLRJND 

PELEM_CHAR_HT 

PELEM_ANNO_CHARJJP_VEC 

PELEM TEXT PATH 
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PELTEXT.ALIGNMENT PELEM_ 

PEL_ANNOTATION_TEXT_CHARACTER_HEIGHT PELEM_ 
PEL_ANNOTATION_TEXT_CHARACTER_UP_VECTOR PELEM_ 

PELANNOTATION_TEXT_PATH PELEM. 

PEL_ANNOTATION_TEXT_ALIGNMENT PELEM_ 

PEL_ANNOTATION_STYLE PELEM_ 

PELJNTERIOR_STYLE PELEM. 

PEL_INTERIOR_STYLEJNDEX PELEM, 

PELJNTERIOR_COLOURJNDEX PELEM. 

PEL_EDGE_FLAG PELEM_ 

PEL_EDGETYPE PELEM. 

PELJEDGEW1DTH.SCALE..FACTOR PELEM_ 

PEL_EDGE_COLOUR_INDEX PELEM. 

PEL_PATTERN_SIZE PELEM_ 
PELJ>ATTERNJ?EFERENCE_POINT__AND_VECTORS PELEM_ 

PEL_PATTERN_REFERENCEJPOINT PELEM_ 

PEL_ADD_NAMES_TO_SET PELEM. 

PEL_REMOVE_NAMES_FROM_SET PELEM_ 

PELJNDIVIDUALJVSF PELEM. 

PELJiLHSRJDENTSFIER PELEM_ 

PEL_LOCAL_MODELLING_TRANSFORMATION3 PELEM. 

PELJ.OCAL_MODELLING_TRANSFORMATION PELEM. 

PEL_GLOBAL_MODELLING_TRANSFORMATION3 PELEM. 

PEL_GLOBAL_MODELLINGJTRANSFORMATION PELEM. 

PEL_MODELLING_CLIPPING_VOLUME3 PELEM. 

PEL_MODELLING_CLIPPING_VOLUME PELEM. 

PEL_MODELLING_CLIPPINGJNDICATOR PELEM. 

PEL_RESTORE_MODELLING_CLIPPING_VOLUME PELEM. 

PELVIEWJNDEX PELEM. 

PELJEXECUTE_STRUCTURE PELEM. 

PEL.LABEL PELEM. 

PEL_APPLICATION_DATA PELEM. 

PEL_GSE PELEM. 

PEL.PICKJD PELEM. 

PEL_POLYLINE_SET3J)ATA PELEM_ 

PEL_FILL_AREA_SET3_DATA PELEM_ 

PEL_TRIANGLE_STRIP3„DATA PELEM_ 

PEL_QUADRILATERAL_MESH3_DATA PELEM. 

PEL_POLYHEDRON3_DATA PELEM_ 

PEL_NONJJNIFORM_B_SPLINE_CURVE PELEM_ 

PEL_NON_UNIFORM_B_SPLINE_SURFACE PELEM. 

PEL_EXTENDED_CELL_ARRAY3 PELEM, 

PELJTEXTCOLOUR PELEM. 

PELJ>OLYMARKER_COLOUR PELEM_ 

PEL_EDGE_COLOUR PELEM_ 

PEL_POLYLINE_COLOUR PELEM. 

PEL_CURVE_APPROXIMATION_CRITERIA PELEM. 

PEL POLYLINE SHADING METHOD PELEM 



TEXT.ALIGN 
ANNO.CHARJ4T 
.ANNO_CHAR_UP_VEC 
ANNO_PATH 
ANNO_ALIGN 
ANNO_STYLE 
JNT.STYLE 
JNT_STYLE_IND 
JNT.COLRJND 
EDGEJFLAG 
EDGETYPE 
EDGEWIDTH 
EDGE_COLR_IND 
PAT_SIZE 

PAT_REFJ»OINT__VECS 
PAT_REF_POINT 
_ADD_NAMES_SET 
_REMOVE_NAMES_SET 
JNDIV_ASF 
HLHSRJD 

LOCAL_MODEL_TRAN3 
LOCALJAODELTRAN 
_GLOBAL_MODELTRAN3 
_GLOBAL_MODEL_TRAN 
_MODEL_CLIP_VOL3 
_MODEL_CLIP_VOL 
MODEL_CLIPJND 
_RESTORE_MODEL_CLIP_VOL 
VIEWJND 
EXEC.STRUCT 
.LABEL 
_APPL_DATA 
GSE 
PICKJD 

_POLYLINE_SET3_DATA 
_FILL_AREA„SET3_DATA 
_TRLSTRIP3_DATA 
QUADJWIESH3_DATA 
_SET_OF_FILL_AREA_SET3_DATA 
_NUNI_BSP.CURVE 
NUNI_BSP_SURF 
CELL_ARRAY3_PLUS 
TEXTCOLR 
_MARKER_COLR 
_EDGE_COLR 
JJNE_COLR 
CURVE_APPROX_CRIT 
LINE SHAD METH 
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PELJNTERIOR.COLOUR 

PEL_BACKJNTERIOR_COLOUR 

PEL_BACK_INTERIOR_STYLE 

PEL_BACK_INTERiOR_STYLEJNDEX 

PEL_AREA_PROPERTIES 

PEL_BACK_AREA_PROPERTIES 

PELJNTERIOR_SHADING_METHOD 

PEL_BACK_INTERIOR_SHADING_METHOD 

PELJNTERIOR_REFLECTANCE_EQUATION 

PEL_BACKJNTERIOR_REFLECTANCE_EQUATION 

PEL_SURFACE_APPROXIMATION_CRITERIA 

PEL_TRIM_CURVE_APPROXIMATION_CRITERIA 

PEL_FACE_DISTINGUISHING_MODE 

PEL_FACE_CULLING_MODE 

PEL_LIGHT_SOURCE_STATE 

PEL_DEPTH_CUE_INDEX 

PEL_COLOUR_MAPPING_INDEX 

PEL_RENDERING_COLOUR_MODEL 

PEL_NUM_EL_TYPES 

PEDITJNSERT 

PEDIT_REPLACE 

PDELETE 

PKEEP 

PERROR_OFF 

PERRORJDN 

PBACKWARD 

PFORWARD 

PFAILURE 

PSUCCESS 



PELEMJNT.COLR 

PELEM_BACKJNT_COLR 

PELEM_BACKJNT_STYLE 

PELEM_BACK_INT_STYLEJND 

PELEM_REFL_PROPS 

PELEM_BACK_REFL_PROPS 

PELEMJNT_SHAD_METH 

PELEMJ3ACKJNT_SHAD_METH 

PELEMJNT_REFL_EQN 

PELEM_BACKJNT_REFL_EQN 

PELEM_SURF_APPROX_CRIT 

PELEM_PARA_SURF_CHARACS 

PELEM_FACE_DISTING_MODE 

PELEM_FACE_CULL_MODE 

PELEMJJGHT_SRC_STATE 

PELEM_DCUEJND 

PELEM_COLR_MAPJND 

PELEM_RENDERING_COLR_MODEL 

PELEM_NUM_EL_TYPES 

PEDITJNSERT 

PEDIT_REPLACE 

PFLAG_DELETE 

PFLAG_KEEP 

PERR_OFF 

PERR_ON 

PDIR_BACKWARD 

PDIR_FORWARD 

PSEARCH_STATUS_FAILURE 

PSEARCH STATUS SUCCESS 
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Routines with Parameter Changes 

pawaif@v@nt 

pc@lfarray3 

pfiilarea 

pfiliaraaSdata 

pgdp3 

pgetloc 

pgetpick 

pgef strokes 

plncrspa§rch3 

pinitloeS 

pinitstrok©3 

pinqannofationfaei! 

pfnqehoicest 

piraqeoteyninodelfaeil 

plnqcyrwsyrffacSI 

pSnqdefcfa©Ie@data3 

pinqdeflocdafa 

pinqdefplckdafa 

pinqdefsfrlngdafa 

pinqdefstrokedata 

pinqd®fva!data 

pinqdesestruet 

pinqextpatrep 

pinqgdpS 

pinqhlhsrfacSB 

pinqinvisfiEf@r 

pinqfocstS 

plnqpafrep 

pinqpicksf 

pinqpredexfpatrep 

plnqstringst 

plnqstrokest 

pioqtextfacSI 

pinqvalst3 

pinqwstran 

pfnqwsfypes 

ppolyh@dron3data 

ppolylin@3 

ppolymarker3 

preqloc 

preqpick 

preqstroke 

preqval 

pretrlevedescstruct 

psampleloc 

psamplepick 

psampSostrokaS 

ps@tinvisfiBt@r 

psetpafsiz® 



c 



pcellarray 

pexfcellarray3 

pfillarea3 

pgdp 

pgetcholce 

pgetloc3 

pgetstroke 

pincrspasrch 

pinitloc 

pinitstroke 

pinqancessfrucf 

pinqarfiles 

pinqchoic@st3 

pinqcurelemconfant 

pinqdefchoicedata 

Jisplayupdafest 
pinqd©f(ocdata3 
pinqd@fpickdata3 
plnqdefsfringdafa3 
pinqdefsfrokedafaS 
pinqd@fvaldata3 
plnqelemoonfenf 
pinqgdp 
pinqhilightfiltar 
pinqinffacil 
pinqlocst 
pinqmarkerfacil 
pinqphigsfacil 
pinqpickst3 
pinqpredpatrep 
pinqsfringst3 
pinqstrokest3 
pinqvalsf 
pinqwsconnfype 
pinqwstran3 
popenpex 
ppolyline 
ppolymarker 
preqchoice 
preqloc3 
preqstring 
preqstroke3 
pretrleveancesstruct 
psamplechoic© 
p$ampI@loc3 
psamplestroke 
psafhilighffilter 
psetpafrefptvectors 
psafpickfiltar 
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B, Change Pages 



The following change pages for the ESV Workstation documentation are at- 
tached. 

ESV Workstation Applications and Options [2.0] 

"Helpful Hints" 

Add these pages to the "Helpful Hints" section in this volume. 

"Application Notes" 

Add these pages to the "Application Notes" section in this volume. 

ES/PSX Document Set II 

Table of Contents 

Substitute these pages for the Table of Contents in the appendices of the 
ES/PSX Document Set II 

Appendix I "Physical I/O" 

Add these pages to the appendices of the ES/PSX Document Set II. 

Appendix H "Release Distribution" 

Substitute these pages for appendix H, "Release Distribution" in the ES/PSX 
Document Set II. 
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Helpful Hints 



For convenience, the helpful hints are divided into the following three cate- 
gories: 

• System, 

• ES/PSX, 

• ES/PEX. 

System 

Porting From BSD-Derived Systems 

ES/os compiles programs under System V or BSD depending on the follow- 
ing: 

• The setting of the PA TH variable in your environment, 

• Use of the -systype option to the compile command. 

In order to successfully compile programs for BSD functionality, you 
must do one of two things: 

1) Use the compile time switch -systype bsd43 which prepends /bsd43 to 
the path for include files and libraries: 

% cc -systype bsd43 -g -o sample sample. c 

2) Place /bsd43/bin before /bin in the PATH variable in your .cshrc, .pro- 
file, or .login file. When you compile, your system goes to the /bsd43 com- 
mand directory and uses the BSD cc command which contains the switch 
-systype bsd43. 

If you want to compile a program for System V functionality and you 
have placed /bsd43 in your path prior to /bin, you must use the -systype 
sysv switch, as in: 

% cc -systype sysv -g -o sample sample. c 

The default compile time switch for /bin/cc is -systype sysv and the de- 
fault compile time switch for /bsd43/bin/cc is -systype bsd43. 



Path 



The path is a list of directories. It traces a sequential route through the file 
structure for the system to follow to locate a particular command or execut- 
able program. The first occurrence of a command found along the path is ex- 
ecuted. 
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BSD Extensions 

The ESV Workstation is UNIX System V with BSD extensions. Commands 
on the ESV Workstation default to System V commands, unless the directory 
specification /bsd43/bin is placed in the path. Placing /bsd43/ bin properly 
in the path allows the operating system to execute the BSD extension com- 
mands. 

Because some System V commands have the same name as BSD exten- 
sions, the position of /bsd43/bin in the path determines which is executed. 

C-Shell and BSD Extensions 

The default path is determined at login by the system. An example of the de- 
fault path for the csh is set as follows: 

set path = (-/bin /usr/net /bsd43/bin /usr/ucb /usr/bin / 
bin /usr/new /usr/bin/Xll) 
Generally, everything in this path except the home directory specification 
is necessary for the proper functioning of your account on the ESV Worksta- 
tion. 

The command env shows what is in your current path. 

Users of the C-shell will probably prefer to use the BSD extensions. Many 
of these extensions have more options than corresponding System V com- 
mands. 

The directory /bsd43/b)n should appear before /usr/bin in the path. 

You can set the path from the command line. Note that setting the path on 
the command line is temporary: the effect of variables set on the command 
line is cancelled by logging out. Use the command set path to put in a new 
command directory at the front of the command line in the C-shell. 

set path = (newcommanddir $path) 

To put a new command directory at the end of the current path enter 

set path = ($path newcommanddir) 

Bourne Shell and BSD Extensions 

The default path for the Bourne shell is as follows: 

PATH=$HOME/bin : /usr/net : /usr/bin : /bin : /usr/ucb : /usr/new : : / 
usr/bin/Xll : /bsd43 

Users of the Bourne shell may not want the operating system to default to 
the BSD extensions when duplicate command names exist. As long as the 
/usr/bin appears before /bsd43/bin in the path, the operating system defaults 
to System V commands. 

You can set the path from the command line. Note that setting the path on 
the command line is temporary: the effect of variables set on the command 
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line is cancelled by logging out. Use the command PATH to put in a new com- 
mand directory at the front of the command line in the Bourne shell. 

PATH=newcommanddir : $PATH; export PATH 

To put a new command directory at the end of the current path enter 

PATH=$PATH:newcon\manddir; export PATH 

• If you login as root, you get System V by default. 

• For additional information, refer to the "ES/os Considerations" sec- 
tion in the "Porting Guide" chapter of the ESV Workstation User's 
Manual [2.0], 

Linking Libraries 

The ES V's X, PEX, and Motif libraries are compiled and linked using UNIX 
Berkeley (BSD) 4.3. Any applications linking to these libraries must also be 
compiled and linked using BSD 4.3 with the -systype bsd34 option to the 
compiler. 

The ESV 2.0 software release changes some of the libraries to which 
programs must be linked. If you have programs that include PHIGS graphics 
and Motif, and are written to the new PEX binding specifications the 
following is the recommended linking order: 

-lXm -lXt -IPEXapi -lXEandSext -IXinput -iXpick -IXext -1X11 \ 
-lXdmcp -lsysv -lm 

where: 

-ixm is the Motif library. 

-lxt is the Xtoolkit. 

-IPEXapi is the PEX library. 

-lXEandSext is the Evans & Sutherland extensions. 

-lxinput is the X input extensions. 

-lxpick is the X picking extensions. 

-lxext is the X extensions. 

-ixnisXHR4. 

-lsysv is a subset of the System V library. 

-lm is the math library. 

If your programs are written to the ES/os 1.3 PEX binding, the following 
is the recommended linking order: 

-lXm -lXt -lPEXapil.3 -IPEXapi -lXEandSext -IXinput -IXpick \ 
-IXext -1X11 -lXdmcp -lsysv -lm 
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where: \^ 

-iPEXapil . 3 is a thin layer translation of the old 1.3 PEX binding to the 
new 2.0 PEX binding. 

Include File Declarations 

The include header files required for a Motif, PEX program should be de- 
clared in the program source code using the following formats: 

♦include <X11/Xlib.h> 

♦include <X11/Intrinsics.h> 

♦include <Xm/Xm.h> 

♦include <Xll/extensions/XInput .h> 

♦include <Xll/extensions/XPick.h> 

♦include <Xll/extensions/Xext .h> 

♦include <Xll/extensions/phigs/phigs .h> etc. 

Sample Makefile 

The following is a sample makefile showing compilation and linking for ES V 
programs using Motif and PEX. 

♦ 

♦ Optional include files can be listed as: 
♦ 

BitMapINCL = /bsd43/usr/include/Xll/bitmaps 
INCLFLAGS = -1$ (BitMapINCL) 

# 

♦ Flags: 

♦ DFLAGS are optional depending on use of ♦ifdef in source 

♦ code. The -g in LDFLAGS can be changed to -0 if debugging is 

♦ not required. The CC_ENVIR0N is needed to increase the size 

♦ of internal compiler tables. 
♦ 

DFLAGS = -DPHIGS_PEX_API -DPEX 
LDFLAGS = -systype bsd43 -g 
CC_ENVIR0N = -Wf,-XNp8400 -Wf r -XNd9000 

CFLAGS = $ (LDFLAGS) $ (CC_ENVIRON) $ (DFLAGS) $ (INCLFLAGS) 

♦ 

♦ Libraries 
♦ 



( 
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MOTIFLIBS = -lXm -lXt 
PEXLIBS = -lPEXapi -lsysv 
XINPUTLIB = -IXinput 
XPICKLIB = -lXpick 
XEXTLIB = -lXext 
XESLIB = -lEandSext 
XLIB = -1X11 

# 

# Be sure that $ (XLIB) follows any others that you use. 
# 

LIBS = $ (MOTIFLIBS) $ (PEXLIBS) $ (XINPUTLIB) $ (XPICKLIB) \ 
$ (XEXTLIB) $ (XESLIB) $ (XLIB) 

# 

# Object files 
# 

MOTIF_PEX_OBJS = sample. o 

# 

# Compilation and Id instructions. The following order is 

# important. $(LIBS) must be last. Note: the $ (CC) causes the 

# CFLAGS to be used on compilation. 

sampleprog: $ (MOTIF_PEX_OBJS) 

$(CC) -o $@ $(LDFLAGS) $ (MOTIF_PEX_OBJS) $(LIBS) 



man -k Command 



The command man -k uses a special database file to look up its information. 
This database file doesn't exist automatically for all man pages. If you want 
to use man -k for all man pages (including PEX, Motif, etc.) you have to build 
the database by running /usr/lib/makewhatis. After installing a package with 
man pages, you should enter /usr/lib/makewhatis while logged in as 
root. This remakes the database to include the new man pages. 



UNIX Sockets 



The UNIX domain sockets should be used whenever possible because they 
can be up to 57% faster than Ethernet sockets for certain applications. Specify 
UNIX domain sockets by setting the DISPLAY environment variable to 
unix:0.0. The client must be running on the same ESV as the server. 
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Unlock Keyboard on CTRL-ALT-BREAK f 

Sometimes, the key sequence CTRL- ALT-BREAK locks up the keyboard. This 
happens when the keyboard is connected to the RDC and you use CTRL- ALT- 
BREAK to exit the X server. The symptoms are that all three LEDs remain lit, 
and the keyboard will not respond to any further typing. 

To unlock the keyboard, cycle the power on the RDC. This leaves the keys 
in a state where the CAPS LOCK key is actually the CONTROL key, and the 
DELETE key emits garbage and back-quotes. Restart the X Server to restore 
the keyboard to its proper operation. 



( 
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ES/PSX 

screen oriented Text 



TE Colors 



The purpose of ES/PSX screenoriented text is to rotate the character string 
so as to make it readable, while maintaining the other attributes (i.e., size and 
position) of its relationship to the object being annotated. This means that 
such text, while always appearing right-side-up, will change size as the asso- 
ciated object is moved toward or away from the user in a perspective view. (It 
will not, however, change size as the associated object is simply scaled in 
modeling space.) 

The above is in contrast to screen_priented/f ixed text, whose size is per- 
manently fixed to the value specified in the applicable CHARACTER SCALE 
or TEXT SIZE commands. 

screen_oriented/fixed text is designed to appear the same size as 
screen_orlented text would be when placed a distance equal to one-half the 
viewport width from the eye for a 90-degree FIELD_OF_V8EW angle. For a 
FIELD_PF_VIEW angle less than 90 degrees, if it is desired to have a string 
of screen_oriented text appear the same size when at screen dep th as a cor- 
responding screen_oriented/f ixed string, the CHARACTER SCALE value 
should be multiplied by the cotangent of one-half the FIELD_OF_VIEW an- 
gle. For example, for a FIELD_0F__V1EW angle of 30 degrees, multiply the 
desired CHARACTER SCALE argument by 3.7321 , which is the cotangent of 
15 degrees. 



The color of the ES/PSX terminal emulator characters and cursor can be mod- 
ified by the following command, which can be included in the site.dat file. 

Send v3d(r,g,b) to <l>tecolor0; 

Note that r,g,h are integers specifying the red, green and blue components of 
the color desired (blue = 0, red=120, green=240). 

The color can also be modified while running ES/PSX by typing the fol- 
lowing commands from command mode: 

Configure a; 

Send v3d(r,g,b) to <l>tecolor0; 

Finish Configuration; 
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ES/PSX and PEX Libraries (^ 

The ES/PSX and PEX libraries provided in the 2.0 Release were all compiled 
using the bsd43 libraries. Modules that are to be linked with these libraries 
should also be compiled as bsd43 modules by using the -sysiype bsd43 op- 
tion in the compile command. If you want to use specific System V routines 
in your programs, you should do so with caution and with explicit knowledge 
as to which libraries are used to resolve external references. 

malloc Fails Even With Swap Space 

Sometimes when attempting to malloc a chunk of memory, the malloc call 
returns a NULL pointer, as if it cannot malloc the space even though vsar 
shows plenty of swap space. This occurs because vsar shows memory that is 
not currently being used, not necessarily that which is free and available. 

In one case, we attempted to malloc a 4* 1280* 1024 chunk of memory. 
We had vsar running which showed more that 40 meg of swap available 
(although free memory had been nearly exhausted). The malloc call returned 
a NULL pointer. 
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ES/PEX 

z-buffering Objects in Depth 



There is an inherent conflict with z-buffering as objects approach each other 
in depth. Polygon edges are at the same z value as the corresponding poly- 
gons. The system moves the edges forward to make them appear in front of 
the corresponding polygons. This can make them appear in front of other 
polygons. 

Anti- Aliased Line Anomalies 

If you turn on HLHSR mode for anti-aliased lines, it may result in a decrease 
in picture quality. The problem is especially evident near the joins of seg- 
ments of curves. If you are only dealing with lines, don't turn on the 
HLHSR mode. If you are mixing lines and polygons, and always want your 
lines to show up, turn off the HLHSR ID when drawing lines. 

Lines Over Polygons 

When drawing lines and polygons, there are some anti-aliasing anomalies 
when the lines are drawn over polygons. You will see fringes that are the 
background color, and the lines look jagged. Refer to the description of 
SET HLHSR MODE in the ES I PHIGS Reference Manual [2.0] for ways to 
avoid this. 

Non-z-Buffered Polygons 

When polygons are not z-buffered, it is inherently unpredictable which of two 
or more overlapping polygons will appear on the screen. It is also possible 
that parts of several polygons may appear in stripes. 

Always z-buffer polygons by turning on the HLHSR mode. 

Inquiry Routines 

After executing a function to open something like PHIGS, a PHIGS worksta- 
tion, or a structure, programmers should call inquiry routines to make sure 
that the intended action occurred. Making sure that a request really occurred 
is the application's responsibility. 

EVALUATE VIEW MAPPING MATRIX 3 

If the projection reference point (PRP) in the 

EVALUATE VIEW MAPPING MATRIX 3 function is set on the front plane, 
all values of z are the same upon transformation. This causes polygon priority 
to be lost and halts depth cueing. If the z- value is constant for all items, there 
can be no visibility resolution, so polygons interleave with other polygons, 
and lines pop in and out. 
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FILL AREA SET 

A FILL AREA SET can be clipped in z such that degenerate edges are intro- 
duced into the polygon description. This causes some pixels to "leak through" 
the two degenerate edges that are introduced. Programmers should reduce the 
number of FILL AREA SETs with holes in order to separate polygons. 

Controlling Line Quality with Hidden-Surface Removal 

There are inherent problems drawing anti-aliased lines with hidden-surface 
removal. The ES V minimizes these as much as possible, and following these 
guidelines will help produce the best possible pictures. 

Disable hidden-surface removal (by setting either the HLHSR mode or 
HLHSR ID to off) when drawing lines over the picture background. With hid- 
den-surface removal disabled, lines blend properly where they cross, even 
when many lines converge (although in this case, there may be a color shift 
towards a saturated color). Disabling hidden-surface removal when drawing 
lines over an object causes the line's color to wash into the color of the object. 
If the background is not black, it can cause fringing of the background color 
on the sides of lines. 

Enable hidden-surface removal (by setting both the HLHSR mode and 
HLHSR ID to on) when drawing only polygons, or when drawing lines over 
a non-constant background, or when drawing polygons and lines freely inter- 
mixed on the screen or in the structure. While there may be some fringing on 
the sides of lines with hidden-surface removal enabled, there will be no color 
shift as lines appear over other objects. Drawing the lines after drawing the 
polygons will reduce the fringing. 

It can also be advantageous to change the HLHSR ID during traversal 
when the HLHSR mode is on, enabling or disabling hidden-surface removal 
for different parts of the image. For example, a guideline grid of lines may ap- 
pear generally over the background and behind the polygons. In this case, a 
good picture may be obtained by turning the HLHSR mode on, then drawing 
the grid with the HLHSR ID off and the object with the HLHSR ID on. Draw- 
ing the grid first produces a different effect than drawing the object first. 

Avoid Intensity Values Near 

Because of the limits of the ES V DACs, colors near in intensity vary dra- 
matically in appearance. For example, a triangle with intensity at one vertex 
and 1 at the other two vertices appears as two bands, one black and the other 
colored. This happens when any of the red, green, or blue components of col- 
or reaches the bottom of the intensity range, regardless of the values of the 
other components. To avoid these problems, avoid using colors near in in- 
tensity. This problem frequendy happens when depth cueing to black or when 
shading without any ambient light; therefore, these should be avoided. 



1 ESV Workstation Applications and Options [2.0] 



c 



c 



c 



Helpful Hints 



Clipping Indicators 

Images are always clipped to the view volume. The clipping indicators con- 
trol whether to clip to the clip bounds within the viewing space. This is self- 
evident in the x- and j-dimensions where the image cannot extend beyond the 
limits of the window. Because of limits on number ranges, this must also be 
so in the z-dimension. Images cannot extend indefinitely in the z-direction, 
but are always clipped at the front and back planes. The clipping indicators 
only control whether to clip to a sub-range defined by the clipping minimum 
and maximum. 

Lines and Polygon Edges Over Solid Polygons 

Because they share the same z- values, lines drawn on the surface of a polygon 
or polygon edges drawn with solid polygons conflict with the polygon interi- 
ors. To increase their likelihood to appear, lines and polygon edges are moved 
forward in the image. For best results, keep the clipping planes as close to the 
object as possible. Extensions to allow user control of this capability are 
planned in future releases. 

WAIT and ASAP Workstation Deferral Modes 

Two different workstation deferral modes supported by ES/PEX: 

• WAIT 

• ASAP 

Under WAIT deferral mode, any PEX routines that can change the visible 
state of the display (modifying table entries, editing a posted structure, etc.) 
are not reflected until the application calls either 
UPDATE WORKSTATION or REDRAW ALL STRUCTURES. 

Under ASAP deferral mode, any PEX routines that can change the visible 
state of the display cause an immediate traversal of all posted structures. 

ASAP mode should be used with caution as it can result in many more tra- 
versal than are necessary. If you are building a large structure network, or 
doing a lot of structure editing, the system finishes the work more quickly if 
it is not continually traversing. The following code fragment demonstrates 
this: 

psetdisplayupdatest (ws, PWAIT, PNIVE); 

/* ... initialize color table, view reps, create structures ... */ 
psetdisplayupdatest (ws, PASAP, PUQUM) ; /* change to ASAP mode */ 
/* ... generate primitives from simulation, etc. ... */ 
psetdisplayupdatest (ws, PWAIT, PNIVE); /* change back to WAIT mode */ 

The default workstation deferral mode is ASAP. 
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BSD Version ps Command 

The BSD version of the ps command is included in the 2.0 release. The op- 
tions to the two commands are not the same. For example, if you were previ- 
ously using ps -ef to get a full listing, the BSD equivalent is ps -aux. If your 
path defaults to the BSD commands, you can still access the System V version 
of ps command as /bln/ps. 

Expose Event for PEX Windows 

When selecting expose events on PEX windows, either through the mecha- 
nism provided by Xlib or the X toolkit (Xt), you should examine the count 
field in the event before causing a structure traversal for the window. 

The X server sends expose events as contiguous groups in the event 
stream, each with a count field indicating how many more expose events are 
in the group. This is done because a single exposure action, such as cycling a 
group of windows via a window manager, can cause multiple regions of a sin- 
gle window to be exposed. Each action that generates such a set of regions 
will generate a set of contiguous expose events in the event stream. 

Since PEX (3D) windows are double-buffered, a portion of the window 
cannot be redrawn without causing a buffer swap. Therefore, as you take 
events off the event queue, you should examine the count field in the expose 
event. When this count is zero, this is the last expose event in its contiguous 
group. At this point, the application can cause a structure traversal and update 
its window. 

Implementing this method can eliminate many unnecessary structure tra- 
versal and improve performance when interacting with window managers 
and other X clients. 

Round Trip Requests to X Server 

Calling a PHIGS routine that returns information about structures to the caller 
(e.g., current element pointer value or structure element content) requires a 
round-trip to the server through network connections. 

The current element pointer value can be maintained by the client while 
building a structure; i.e., the client may know how many structure elements it 
has inserted into the currently open structure. Maintaining this information in 
the client program can result in performance increases since the time required 
for obtaining the current element pointer value can be expensive for a very 
large structure. Obtaining this value typically requires a linear traversal of the 
structure from the beginning until the current element is reached. 

Client-side optimizations that result in fewer round-trip messages are the 
smart thing to do. 
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Resizing of PEX Windows 

X and PHIGS have slightly different ideas about the dynamics of a display 
surface. Under X, display windows can be resized by the user or another pro- 
gram, and the client receives a Conf igureNotify event. Under PHIGS, the 
usable portion of a window is determined by the workstation transformation 
matrix. 

The workstation transformation matrix is controlled by 
SET WORKSTATION VIEWPORT, SET WORKSTATION VIEWPORT 3, 
SET WORKSTATION WINDOW, and SET WORKSTATION WINDOW 3. 

Using the 2D versions of the routines, you can examine your new window 
size from the Conf igureNotify event and adjust the size of your PHIGS dis- 
play surface accordingly. 

PHIGS specifies that when a workstation is opened, it uses the largest 
square in the upper-left portion of the workstation, unless the workstation 
transformation is explicidy changed. The workstation window and viewport, 
which together define the workstation transformation, must be set to the same 
aspect ratio when they are changed. 

When a PEX window is resized, the client application has several choices 
to make regarding the workstation transformation. It can render the entire 
NPC space to any square portion of the window's new size, preserving aspect 
ratio. Another option is to limit the portion of NPC space shown in the resized 
window, making the window a "porthole" into NPC space. This requires a 
considerable amount of programming. 

The following code fragment is an example of resizing the PHIGS display 
surface to be the largest (centered) square in the resized window: 

XNextEvent (&event) ; 

if (event. type == Conf igureNotify) 

{ 

Plimit viewport; 

int width, height; 

width = event .xconfigure .width; 

height = event .xconfigure .height; 
if (height > width)/* window is taller than wide */ 

{ 

viewport .xmin = 0; 

viewport .xmax = width-1; /* use entire width */ 

viewport .ymin = (height-width) /2; 

viewport .ymax = viewport .ymin + width-1; 

/* center vertically */ 

} 
else /* window is wider than tall */ 
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{ 

viewport .ymin = 0; 

viewport .ymax = height-1; /* use entire height */ 
viewport .xmin = (width-height) /2; 
viewport .xmax = viewport .xmin + height-1; 
/* center horizontally */ 
} 

psetwsviewport (ws, & viewport) ; 
predrawallstruct (ws, P ALWAYS) ; 
} 
else /* other events */ 

Remember that device coordinate space is in pixels and relative to the or- 
igin of the X window. Also, X coordinate structures have ay-axis that increas- 
es down the screen, while the PfflGS y-axis increases up the screen. 

Pick Highlighting 

When the prepick control is set to highlight picked commands, the color of 
markers within the boundary of the pick box is changed. Optionally, the color 
changes for markers in the same node as the one within the pick box. When 
this happens, markers within the node that preceded the one picked have al- 
ready been drawn. Their color is a combination of the highlight color and 
their normal color. 

Known Size Limitations on Structure Elements 

Since structure elements are communicated to the central structure store via 
the connection to the X server(s), structure elements are limited in size by the 
request buffer size of the server. The request buffer size can be found from 
the xdpyinfo(1) command. Currently, the buffer size is 64 K long words, or 
256 Kbytes. 

For polygon (FILL AREA, FILL AREA SET, etc.) structure elements, 
there is a further restriction of no more than 128 vertices (64 if the primitive 
includes colors or normals, 42 if the element includes colors and normals for 
each vertex) per element. This limitation is imposed by the size of the pro- 
cessing buffer in the DSPs. 

Optimization of Structure Element Size for Performance 

When writing PHIGS/PEX clients, it is important to remember that the ES V 
Workstation contains between 4 and 44 DSPs that render the set of posted 
structures. Splitting large structure elements into a group of smaller, equiva- 
lent structure elements can improve rendering performance. The overhead for 
an extra element on a low-end system is negligible and results in approxi- 
mately the same rendering time. However, on a high-end system, the result is 
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a greater degree of data parallelism. This means more efficient use of the DSPs 
and higher rendering throughput This throughput is limited by communica- 
tion speeds and other basic architectural trade-offs, but a performance gain 
can be usually achieved by splitting large structure elements into smaller 
ones. 

For optimum performance, a match must be obtained between the size of 
rendering primitives within a structure, their relationship to one another and 
the number of output primitives in the structure. A structure that contains a 
high ratio of execution (via EXECUTE STRUCTURE) to drawing (via output 
primitives, i.e., lines, polygons) can cause excessive overhead on the host 
CPU in structure traversal. Conversely, a structure with a high drawing to ex- 
ecution ratio (i.e., flat) can consume large amounts of host structure memory 
and may be adversely effected by system paging. The best approach is to at- 
tempt to balance these effects. 

Some output primitives are broken up by the system to increase available 
parallelism in rendering these primitives. Since the rendering pipeline of the 
ESV consists of parallel processors combining their results into the frame 
buffer, performance gains can also be achieved by judiciously adjusting the 
size and number of output primitives. For increased performance, the follow- 
ing guidelines should be followed, keeping in mind they are only guidelines, 
not guarantees. 



Text functions include TEXT, TEXT 3, ANNOTATION TEXT RELATIVE, and 
ANNOTATION TEXT RELATIVE 3. Longer character strings perform better 
than short character strings. Single character strings used as markers are less 
efficient than marker elements. 



Polygonal structure element functions include FILL AREA, FILL AREA 3, 
FILL AREA SET, FILL AREA SET 3, FILL AREA 3 WITH DATA, and FILL 
AREA SET 3 WITH DATA. Polygonal structure elements with less than 14 
vertices require less complicated processing during scan conversion. Process- 
ing of convex primitives is optimized. 

Quadrilateral Mesh and Triangle Strip 

Quadrilateral mesh and triangle strip functions include QUADRILATERAL 
MESH 3 WITH DATA and TRIANGLE STRIP 3 WITH DATA, and they have 
unique performance characteristics. For optimum performance, a match must 
be obtained between the number of meshes and their size. A few small mesh- 
es that can be rendered in parallel will be faster than a single large mesh, since 
the primitive level is the lowest level at which parallelism is applied. 
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The system breaks up meshes and strips that are larger than 500 words. 
This overhead can be avoided if the primitives are kept below 500 words. 
This translates into the following guidelines (these numbers are derived from 
the packet sizes defined in the PEX V4.0 Protocol Encoding document). 
There are about four words of header for each of these primitives, and the re- 
maining space is left for vertices and optional vertex data. That leaves 496 
words for this data: 

• 165 vertices with no colors and no normals 

• 82 vertices with colors or normals 

• 55 vertices with colors and normals 

These numbers calculated by dividing 496 by 3, 6, and 9, respectively. 

Setting Size of Socket Buffer Length Can Degrade Performance 

Using setsockopt(fd, SOL_SOCKET, SO_SNDBUF, ...) can kill network 
I/O performance if the buffer size is less than the system default of 4096. It 
took 7 1/2 hours to move 16Mb with 1/4M packets of 64 bytes each when the 
kernel buffer size was set down to 256 bytes. Use the default kernel buffer 
size. 

pfillareasetS 

pfillareaset3 does not draw the polygon if the length of one of the sides is 
below a certain value. The side in question in the example below is the length 
between <vertex 4> and <vertex 5>. 

Example code: 

ploss () 
{ 

/* Define polyline cube vectors */ 
Ppointlst3 side; 
static Ppoint3 points []= 
{{ 0.8768756, 0.1534203, 0.0} , { 0.8772517, 0.1693954, 0.0} , 
{ 0.8563184, 0.1754968, 0.0} , { 0.8558692, 0.1591864, 0.0} , 
{ 0.8559113, 0.1589217, 0.0}}; 

side. number — 5; 
side. points = points; 

popenstruct (FILLBOX) ; 
psetintstyle (PSOLID) ; 
psetintcolourind(7) ; 
pfillareaset3 (1, Sside) ; 
pclosestruct () ; 
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popenstruct (DISPLAY_STRUCT) ; 

psetviewind(VIEW) ; 

pexecutestruct (FILLBOX) ; 
pclosestruct () ; 

ppoststruct(WS, DISPLAY_STRUCT, 1) ; 

pupdatews (WS f PPERFORM) ; 

} 

PHIGS requires the first three vertices to determine front or back facing. 
If the first three vertices are colinear, then use the next point. But the colin- 
earity test depends on the precision. If the tolerance is too low (the present 
case), it mislabels polygons. If the tolerance is too high, it may miss pertinent 
data (for example, presume all the sides of the above polygon were as short 
as the offending vertex). So, do not define the first two sides of a polygon to 
be abnormally short. 

Multiple Connections to the Same X Server 

There are certain situations that can cause multiple connections to the same 
X server when using both X and ES/PEX calls. These situations can cause 
some undesirable visual effects. 

• If you are using XOpenDisplay to get a Display *, that pointer should 
be used in a popen_xphigs call in order to prevent multiple connec- 
tions. If XOpenDisplay is used, popen_phlgs should not be used to 
open PHIGS. 

• If you are using XOpenDisplay and opening workstations of type 
phigs_ws_type_x_tool, and if a value is specified for connection ID, 
the value should be the same as a the value given to XOpenDisplay 
for connection to that display. 

Correct Usage Example 

Display *display; 
Pxphigs_info xinfo; 

display = XOpenDisplay ("") ; 

xinfo. display = display; 

popen_xphigs (PDEF_ERR_FILE, PDEF_MEM_SIZE, 
PXPHIGS_INFO_DISPLAY, &xinfo) ; 

popen_ws (1, "" , phigs_ws_type_x_tool ) ; 
or 

popen_phigs(PDEF_ERR_FILE, PDEF_MEM_SIZE) ; 
popen_ws(l, NULL, phigs_ws_type_x_tool) ; 
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Incorrect Usage Example C 

Display *display; 
Pconnid_x_drawable xdraw; 
Window win; 

display = XOpenDisplay P") ; 

popen_phigs(PDEF_ERR_FILE, PDEF_MEM_SIZE) ; 

win - XCreateSimpleWindow{ . . . ) ; 
xdraw. display = display; 
xdraw. drawable_id = (XID)win; 

popen_ws(l, fixdraw, phigs_ws__type_x_drawable) ; 

Faster PHIGS Text 

Text performance can be improved by setting the text path to PTP_RIGHT, 
the horizontal alignment to PAH_NORMAL, the vertical alignment to 
PAV_NORMAL, and the text spacing to a non-negative value. If these criteria 
are met, text speed is improved. 



editres 



The editres client message protocol provides the capability to allow one cli- 
ent to perform an XtSetValues/XtGetValues operation on another client's 
widget tree. This is the fundamental mechanism behind the program editres, 
which allows interactive editing of an application's resources while the appli- 
cation is executing. See the manual page on editres(f) for more details. 

Developers wishing to take advantage of the EdifRes client message pro- 
tocol need to make sure that the editres protocol message handler is initial- 
ized and that the editres message event handler is added to their application. 
The Athena widget set's VendorSheil widget does this when it is initialized. 
This makes the editres protocol available to all applications based on the 
Athena widget set. For applications using the VendorSheil in the Motif wid- 
get set, the application should call the following procedure: 

XtAddEventHandler(topLevel, (EventMask) 0, TRUE, 
_Edi t Re sCheckMes sages, NULL) ; 
where topLeve! is the widget ID returned by XtApplnitialize. 

The application will need to be linked with the Xmu library, which con- 
tains the editres client message protocol handling routines. 



Facet Normals 



If facet normals are not specified, they are calculated from the last vertices 
instead of from the first vertices. 
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AN1. Exabyte 



Functional Characteristics 



Exabyte is a proprietary cartridge tape subsystem. The Exabyte 8200 trans- 
fers data at the rate of 246 Kbytes per second and uses standard 8 mm tape 
cartridges. Tape cartridges are available in five user-selectable sizes which 
support data capacities from 291 Mbytes to 2.332 Gbytes. 



Product Details 



The model we tested is an Exabyte "8200" with a manufacture date of July 
29, 1989. The part number is 1 10060-A01. An SCSI cable is required and an 
SCSI terminator might also be required. 

Supplemental Information 

Always shutdown the ES V Workstation and turn off the power when install- 
ing or removing SCSI devices. It is suggested that the SCSI ID be set to 4 or 
5. This allows the use of tape devices /dev/rmt/hcO or /dev/rmt/h0, which are 
preconfigured device names. Logical block sizes of 5 12 bytes and 1024 bytes 
were used for testing. 

Suggested Vendors 

The Exabyte 8200 can be purchased from: 

R Squared 

1 121 1 E. Arapahoe Road, Suite 200 

Englewood, CO 80112 

Telephone: 800-777-2478 

FAX: 303-799-9297 

An SCSI cable and terminator can be purchased from Evans & Sutherland. 
The actual SCSI connection equipment required will depend on the number 
and type of other devices that are connected to the SCSI bus and the model or 
revision level of the Exabyte drive. 
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AN2. Trackball 



Product Details 



The trackball is an alternate input device that is a direct replacement for the 
mouse. The ESV trackball is a true 3-button device which allows the user to 
roll the ball with the thumb while the fingers are free to operate the buttons. 
The trackball requires a space of about 5.4 by 4.25 inches and has a default 
DPI of 300. A trackball is often preferred for plotting points in CAD-type op- 
erations or just selecting menu choices. A mouse is generally preferred for 
freehand drawing applications. The trackball comes with a 9 foot cable. The 
case and buttons are "mist/fieldstone" in color and the ball and the cable are 
grey. 



Supplemental Information 



The trackball requires minor modification for ESV compatibility and cannot, 
therefore, be purchased directly from dealers for use with the ESV Worksta- 
tion. The effective DPI of the trackball (and mice) can be adjusted with the 
xset command. The E & S part number for the trackball is 220725-100. The 
trackball is purchased from Logitech, Inc. (OEM Division). 
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AN3. Serial-to-Parallel Converter 



Functional Characteristics 

The serial-to-parallel converter can be used to interface the ES V Workstation 
to a parallel Centronics device such as the IBM Proprinter. Baud rate, charac- 
ter length, parity, handshake mode, and conversion direction can be set with 
dip switches. The handshake mode can be set to either the X- ON/OFF or the 
DTR mode. This converter can convert data in either direction and has a 
64 Kbyte buffer. 

Product Details 

The parallel port on the converter has a Centronics type 36-pin female connec- 
tor. The serial port has a DB25 male connector. An AC-to-DC adapter comes 
with the converter, but cables must be purchased seperately. A null-modem 
adapter is also required for use with the ES V Workstation. 

Supplemental Information 

The converter was tested with an IBM Proprinter using the X- ON/OFF hand- 
shake mode. The DTR handshake mode has not yet been successfully tested. 
All parts can be purchased from: 

Dalco Electronics 
223 Pioneer Blvd. 
Springboro, Ohio, 45066 
Telephone: (800) 445-5342 
FAX: (513) 743-9251 



Parts List 



BIDIRECTIONAL CONVERTER 

Cost: $138.50 

Part number: 78870 

CABLE, Centronics 36 Pin male to 36 pin male, 6 feet. 

Cost: $8.95 

Part number: 38680 

CABLE, DB25 male to DB25 female, 6 feet. 

Cost: $7.95 

Part number: 38630 

NULL MODEM, DB25 male to female. 

Cost: $6.95 

Part number: 78610 
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AN4. Video Extension Cables 



Functional Characteristics 



These video extension cables allow the ESV cabinet to be placed 150 feet 
away from the work area. 

Product Details 

The cable assembly consists of 150 feet of large, RG11, low-loss cables and 
smaller, RG59, 6 foot cables which are attached to both ends of the large O.D. 
cable. The smaller cables are provided to facilitate attachment to the ESV and 
the display monitor. Suitable connectors are provided for coupling the cables 
together. All cables are color coded to simplify assembly. 

Supplemental Information 

These cables have not been tested by E&S for electromagnetic emissions. 
"Teflon" cables are also available if the cables are to be routed through ple- 
num areas. Use of these cables requires configuration with the Reprogramma- 
ble Data Concentrator (RDC). 



Vendor 



Parts List 



Network Technologies, Incorporated 

7322 Pettibone Road 

Chagrin Falls, Ohio 44022 

Telephone: (216) 543-1646 & 1-800-RGB-TECH 

FAX: (216) 543-5423 



3 RG11 Coax + BNC-N adapters + RG59 cables 

Cost: $295.00 

Part Number: 3C-RG1 1-150 
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AN5. Distribution Amplifiers 



Functional Characteristics 

Distribution amplifiers allow the ES V workstation to simultaneously drive as 
many as 12 monitors or additional video equipment, such as a video printer. 

Product Details 

These distribution amplifiers are attractively packaged and are suitable for 
desk-top placement. Rack-mount units are also available. Model numbers are 
designated as VOPEX-3 ANH with the "N" in the model number indicating the 
number of outputs. The VOPEX-3A2H, for example, has three input 
connectors, one each for red, green and blue and two output connectors for 
each color (six total output connectors). Installation is straight forward and 
interface cables are included. Inputs and outputs are via female BNC 
connectors. No termination is required for unused outputs. The size of the 
VOPEX-3A2H model is approximately 3 5/16x7x41/8 inches. NTI products 
do not have UL or EMI certifications which is not uncommon with this type 
of product. 

Supplemental Information 

The proper cable must be used to insure that display clarity is not compro- 
mised (see application note(s) on video extension cables). 



Vendor 



Price List 



Network Technologies, Incorporated 

7322 Pettibone Road 

Chagrin Falls, Ohio 44022 

Telephone: (216) 543-1646 & 1-800-RGB-TECH 

FAX: (216) 543-5423 



Two output RGB 

Cost: $500.00 

Part Number: VOPEX-3A2H 

Four output RGB 

Cost: $840.00 

Part Number: VOPEX-3A4H 
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• Six output RGB 

Cost: $950.00 

Part Number: VOPEX-3A6H 

• Eight output RGB 

Cost: $1220.00 

Part Number: VOPEX-3A8H 

• Ten output RGB 

Cost: $1920.00 

Part Number: VOPEX-3A10H 

• Twelve output RGB 

Cost: $2100.00 

Part Number: VOPEX-3A12H 
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AN6. CIPHER Tape Drive 



Functional Characteristics 

This tape drive utilizes Group Code Recording (GCR) formatting, 9-track data 
interchange and recording densities of 1,600 bits per inch or 6250 bits per 
inch. Unformatted capacity is 270 Mbytes with 3600 foot reels at 6,250 bits 
per inch. Read and write tape speed is 100 in/sec. There is 1 Mbyte of cache 
memory. 

Product Details 

The M995S measures 8 3/4 inches high by 17 inches wide by 25 inches long. 
The weight is 68 pounds. Mounting options are rack mounting, standard 
19-inch EIN/RETMA and desktop enclosure. The M995S has an autoranging 
power supply that automatically adjusts to 1 10 and 220 VAC power sources 
and it has UL, CSA, TUV, and FCC certification. Additional product informa- 
tion can be obtained by calling Cipher sales at 1-800-4CIPHER. European 
customers may telephone 07341/775757. 

Supplemental Information 

Always shutdown the ES V Workstation and turn off the power when install- 
ing or removing SCSI devices. It is suggested that the SCSI ID be set to 4 or 
5. This allows the use of tape devices /dev/rmt/hcO or /dev/rmt/h0, which are 
preconfigured device names. Logical block sizes of 512 bytes and 1024 bytes 
were used for testing. 

Suggested Vendor 

Vincent Simmons, Field Sales Manager 
Arrow Electronics, Inc. 
1946 West Parkway Boulevard 
Salt Lake City, Ut 841 19 
Telephone: (801) 973-6913 



ESV Workstation Applications and Options [2.0] AN6 - 1 



Application Notes 



Parts List 



C 



Otv. Description Cipher P/N E&SP/N Est, Cost 

1 Cipher 1/2" Tape Drive M995S $7400.00 

1 Desk-Top Enclosure ENVENM-995S $ 400.00 

1 *SCSI Cable 423203-006 

1 SCSI Terminator 401258-050 

1 Tape Path Cleaning Kit 960855-001 $ 30.00 

*This is the correct cable if the M995S is the only device connected to the ex- 
ternal SCSI bus. A different cable might be required if additional equipment 
is connected to the external SCSI bus. 
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AN7. External SCSI Cables and Terminators 

Overview 

The nature of SCSI will occasionally require custom configurations for indi- 
vidual customers. In addition, some forethought may be required to insure 
that the customer receives the correct cables in a timely fashion. This appli- 
cation note, then, describes the available external SCSI connection equipment 
and the pertinent SCSI operating parameters. 

Operating Parameters 

A total of seven SCSI devices can be connected to the SCSI bus, in addition to 
the CPU. This means, for example, that four devices can be connected via ex- 
ternal cables if the ES V Workstation has one tape drive and two disk drives 
installed inside the cabinet. 

There is an input and output connector provided on each external SCSI 
device. The input connector accommodates the cable from the host or 
previous device. The output connector is provided to allow for daisy chain 
configurations to the next device or the placement of a terminator. A resistive 
network (terminator) must be attached to the last device in the daisy chain. 
Some devices have internal terminators which may be installed or removed. 
In most cases, however, the terminator will be installed on the output 
connector. 

The total length of the external cable(s) cannot exceed 10 feet. This 
limitation includes SCSI cables that are often found inside external SCSI 
equipment such as disk-drive enclosures. Failure to properly install a 
terminator, the presence of more than one external terminator or the use of 
cable exceeding 10 feet may cause a system crash. 



Terminators 



SCSI connectors have not been standardized. The DS-2000 Data Shuttle, for 
example, has a male "subminiature-D" (Sub-D) output connector. The 
KODAK XL7700 printer has a female "alternate 2" (Alt-2) output connector. 
The ES V Workstation has a female Sub-D output connector. There are, there- 
fore, three terminators available: 

1) E&S P/N 401258-050 (Alt-2 male connector). This type of terminator 
is also called "Amp Champ" or the "Centronics" type. The KODAK 
printer is an example of a device that uses this type of terminator. 

2) E&S P/N 401272-050 (Sub-D male connector). The ESY Workstation 
uses this terminator. 
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3) E&S P/N 401294-050 (Sub-D female connector). This is an uncommon 
terminator that will probably be used only with the DS2000 Data Shut- 
tle. 



Cables 



It is recommended that only ES V Workstation cables be used with SCSI de- 
vices in order to avoid impedance discontinuity and EMI problems. There are 
eight cables available. Cables (1) and (2) will probably be used most often. 
Cables (3) and (4) can be used to help create custom configurations. Cables 
(5), (6), (7), and (8) are for use with the MDB Data Shuttle or other devices 
that have uncommon connectors: 

1) E&S P/N 423203-006 (Male Alt-2/Male Sub-D ? 6 Feet). This cable has 
a Centronics connector on one end and a Sub-D on the other. It is cur- 
rently being used to connect the ES V Workstation to the Kodak printer 
and to other devices that have a Centronics input connector. 

2) E&S P/N 401013-002. (Male Alt-2/Male Alt-2, 2 Feet). This cable has 
a Centronics connector on both ends. This is probably the most common 
cable for daisy chaining SCSI devices. The Kodak printer and CDROM 
drive could, for example, be connected together using this cable. 

3) E&S P/N 423203-002. Two-foot version of 423203-006. 

4) E&S P/N 401013-006. Six-foot version of 401013-002. 

5) E&S P/N 401010-006 (Male Sub-D/Male Sub-D, 6 Feet). This cable 
has a Sub-D connector on both ends. It is currently used to connect the 
ESV Workstation to the DS2000 Data Shuttle. 

6) E&S P/N 401010-002. Two-foot version of 401010-006. 

7) E&S P/N 401012-002. (Male Alt-2/Female Sub-D, 2 Feet). This cable 
can be used to daisy chain devices such as the Kodak printer to the 
DS2000 Data Shuttle. 

8) E&S P/N 40101 1-002. (Male Sub-D/Female Sub-D, 2 Feet). This cable 
can be used to daisy chain DS2000 Data Shuttles. 
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